home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / packet / mopt118 / msys118.doc < prev    next >
Text File  |  1994-11-21  |  503KB  |  14,751 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                        MSYS
  10.  
  11.                      (C) Copyright 1994 By HUB COMPUTERS, INC.
  12.                                 All Rights Reserved
  13.  
  14.  
  15.                                    INTRODUCTION
  16.  
  17.  
  18.        MSYS is a Copyrighted program that I am making available to the
  19.        amateur radio community free of charge.  Source code is not generally
  20.        available (if you want it you will have to pay dearly for it!).
  21.  
  22.        KA-NODE and GTOR are trademarks of Kantronics Inc.  The KANODe
  23.        component of MSYS is compatible with the Kantronics KA-NODe but is
  24.        completely different code from that used in the Kantronics tncs.
  25.  
  26.        NET/ROM is a trademark of SOFTWARE 2000.  The network NODe component
  27.        of MSYS is compatible with NET/ROMs but is completely different code
  28.        from that sold by SOFTWARE 2000.
  29.  
  30.        The network NODe component of MSYS is completely different from that
  31.        in the KA9Q-NOS program and G8BPQ Node software.
  32.  
  33.        IBM is a trademark of International Business Machines Corp.
  34.  
  35.        SAM is a trademark of RT Systems
  36.  
  37.        j-comm is a trademark of j-comm Inc.
  38.  
  39.        MSYS is available from the Cleveland Hamnet phone BBS.  The number is
  40.        216-942-6382.  It's speed is 1200 to 14,400 baud.  This is a free BBS
  41.        (you pay for the call).  MSYS may also appear on other phone BBS
  42.        systems, but this is the only one I put it on directly.  MSYS may
  43.        also be obtained by anonymous ftp on Internet from
  44.        coffman.csuohio.edu  [137.148.21.6].
  45.  
  46.        You may also obtain MSYS from me directly on disk.  Distribution is
  47.        on 5.25 inch 360K formatted disks. Costs per disk which includes the
  48.        disk, mailer and postage are as follows:
  49.                         U.S.                $5.00 per disk
  50.                        Canada & Mexico     US$7.50 per disk
  51.                        All Others          US$10.00 per disk
  52.  
  53.  
  54.  
  55.  
  56.  
  57.        The number of disks may vary from release to release.  Recent
  58.        releases have been one disk to three disks.  Four disks may be needed
  59.        in the future.  You may order several versions at a time, I will hold
  60.        your request until the versions are released.  This way you get to be
  61.        the first kid on the block with the new toy!  When ordering from me,
  62.        please specify which version you already have or which one you want..
  63.        I keep records with the following information for people who order
  64.        MSYS, so you may want to give me this info.  Also please indicate if
  65.        you want me to call you (collect) if it would be helpful to answer
  66.        questions you send me about MSYS.
  67.  
  68.        CALL:          Your callsign.  This is the key I use to record all
  69.        your                information.
  70.        NAME:          Where to send the disk to!
  71.        ADDRESS LINE 1:
  72.        ADDRESS LINE 2:(if needed)
  73.        CITY:
  74.        STATE:
  75.        ZIP:
  76.        COUNTRY:
  77.        TELEPHONE:     If you want me to call you back (collect)
  78.        VERSION:       The version you have now
  79.        OWED:          How many you have prepaid
  80.        COMPUTER:      Speed, memory, disk space, CPU chip etc.
  81.        TNC:           Model & ROM versions
  82.        DOS:           Which version?
  83.        BBS:           BBS callsign to send you msgs .
  84.        IP:            Your IP address, if you have one
  85.  
  86.        Mail requests for MSYS on disk to:
  87.        Michael Pechura
  88.        10809 Beechwood Drive
  89.        Kirtland, OH 44094
  90.  
  91.        You may call me with questions/comments at   216-256-1588.
  92.  
  93.        A stripped down version of MSYS that supports only the BBS functions
  94.        is also available.  There is no network NODe, no amtor, no tcp/ip in
  95.        this version.  You can still forward using external network nodes,
  96.        but the bbs is NOT a netrom network node!  The KANODe is still there.
  97.        All of the BBS functions remain, along with modem support.  Expanded
  98.        memory is also still supported.  This version is called MSYSB and is
  99.        available on a separate disk or on Cleveland Hamnet.  If want to get
  100.        this disk from me, it is the same price as the others: $5 to US
  101.        addresses, $7.50 to Canada and Mexico, and $10 to other countries.
  102.  
  103.  
  104.                             Internet Group being Formed
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.        MSYS 1.18                                                   Page ii
  112.  
  113.  
  114.  
  115.  
  116.  
  117.        This deals with a Internet network mailing list.  You have to have
  118.        access to Internet mail to participate.  For those of you who have
  119.        not experienced a mail list, it is a program that runs on a computer
  120.        connected to the Internet.  Anyone posting a message to a special
  121.        address on that computer has that message echoed to all members on a
  122.        mail list.  It is, essentially, a newsgroup limited to those who wish
  123.        to subscribe.
  124.  
  125.        A new mail list has been created to help with communications between
  126.        MSYS sysops.  It has been created by the same people who brought you
  127.        the Cleveland Hamnet BBS which is the primary host for MSYS.  A
  128.        number of active MSYS sysops will insure that questions get reviewed
  129.        and suggestions are made.
  130.  
  131.                               ADMINISTRATIVE MESSAGES
  132.  
  133.        You must send a message to a different address than the message which
  134.        is used to post items to the group.  Please, if you subscribe, save
  135.        these addresses so you can modify your subscription later.  PLEASE
  136.        don't send subscribe and unsubscribe messages to the posting address.
  137.  
  138.  
  139.                                    To Subscribe:
  140.  
  141.                msys-request@hamnet.wariat.org
  142.                <subject> subscribe
  143.                no body text
  144.  
  145.                You will get a ack when your subscription is registered.
  146.  
  147.  
  148.                                   To Unsubscribe:
  149.  
  150.                msys-request@hamnet.wariat.org
  151.                <subject> unsubscribe
  152.                no body text
  153.  
  154.  
  155.                                    To get help:
  156.  
  157.                msys-request@hamnet.wariat.org
  158.                <subject> help
  159.                no body text
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.        MSYS 1.18                                                   Page iii
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                                  POSTING ADDRESS:
  179.  
  180.                msys@hamnet.wariat.org
  181.  
  182.  
  183.                                      PROBLEMS:
  184.  
  185.                no8m@hamnet.wariat.org
  186.  
  187.  
  188.        Thanks to Dave, WB8APD, for setting this up!
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.        MSYS 1.18                                                   Page iv
  234.  
  235.  
  236.  
  237.  
  238.  
  239.                      A Multi-User, Multi-Port, Multi-Function
  240.  
  241.                              Amateur Packet Radio BBS
  242.  
  243.                               By Mike Pechura, WA8BXN
  244.  
  245.                      (C) Copyright 1994 By HUB COMPUTERS, INC.
  246.                                All rights reserved.
  247.  
  248.                             Version 1.18  NOVEMBER 1994
  249.  
  250.                        MSYS Documentation Table of Contents
  251.  
  252.        INTRODUCTION...........................................................I
  253.          INTERNET GROUP BEING FORMED.........................................II
  254.        MSYS DOCUMENTATION TABLE OF CONTENTS...................................V
  255.        MSYS INITIAL INSTALLATION..............................................1
  256.        MSYS UPDATE INSTALLATION INSTRUCTIONS..................................3
  257.          SETUP CHANGES........................................................3
  258.          ADDITIONS & CHANGES..................................................4
  259.          KNOWN PROBLEMS WITH THIS RELEASE.....................................5
  260.          MSYS COMMAND LINE....................................................6
  261.          ABBREVIATIONS/CONVENTIONS............................................7
  262.        MSYS DIRECTORY LAYOUT DESCRIPTION......................................8
  263.          MSYS.OPT............................................................10
  264.        MASK INFORMATION......................................................20
  265.        BIT PATTERN CHART.....................................................20
  266.        DRSI CARDS............................................................22
  267.        MSYS COMMAND SUMMARY..................................................23
  268.          MSYS SYSOP COMMANDS.................................................31
  269.          MSYS BBS USER COMMANDS..............................................71
  270.        REQXXX SERVERS........................................................83
  271.        CALLSIGN SERVER.......................................................85
  272.          THINGS NEEDED TO MAKE THE CD-ROM DATA BASE CALLSIGN SERVERS WORK:...85
  273.          THINGS NEEDED TO MAKE THE SAM (C) DATA BASE CALLSIGN SERVER WORK:...86
  274.        MODEM SUPPORT.........................................................87
  275.          MSYS MODEM FORWARDING PROTOCOL......................................87
  276.          INCOMING CALL PROTOCOL..............................................87
  277.          MSYS.OPT FILES......................................................89
  278.          MSYS.DO.............................................................89
  279.          MSYSTNC.X FILES.....................................................90
  280.          MODEM USAGE AT 4.8, 9.6 AND 14.4K...................................92
  281.          NETNODE USAGE.......................................................92
  282.        FORWARDING............................................................93
  283.          FILE SETUP..........................................................93
  284.        FORWARD FILE DESCRIPTION..............................................94
  285.          (CALLSIGN).FWD/.REV FILES...........................................97
  286.          REVERSE FORWARD.....................................................98
  287.          SELECTIVE FORWARDING................................................99
  288.          TO FIELD FORWARDING................................................101
  289.          MERGE:.............................................................101
  290.        FORWARDING NOTES.....................................................102
  291.          FORWARDING DISPLAY.................................................103
  292.  
  293.  
  294.        MSYS 1.18                                                   Page v
  295.  
  296.  
  297.  
  298.  
  299.  
  300.          BIDS...............................................................103
  301.          MISSING TEXT TO MESSAGE............................................104
  302.          NODE SCRIPTS.......................................................105
  303.          MSYS NODE FORWARDING...............................................107
  304.          FORWARDING TO JNOS SYSTEMS.........................................107
  305.          HF FORWARDING......................................................108
  306.          PACTOR FORWARDING..................................................108
  307.          GTOR FORWARDING....................................................108
  308.          SMTP FORWARDING....................................................110
  309.          FBB COMPATIBLE FORWARDING..........................................111
  310.          FBB COMPATIBLE COMPRESSED FORWARDING...............................112
  311.          W0RLI STANDARD FOR DATA COMPRESSION DURING THE FORWARDING OF
  312.          MESSAGES IN THE AMATEUR RADIO BBS NETWORK..........................114
  313.          FORWARDING ON THE MODEM PORT.......................................116
  314.          FBB ON THE PHONE...................................................117
  315.          FORWARDING TO AA4RE SYSTEMS........................................117
  316.          ANONYMOUS CHECK-INS................................................118
  317.          ACOUSTIC COUPLED MODEMS............................................120
  318.          MISCELLANEOUS NOTES................................................120
  319.          MSYS.REP...........................................................121
  320.          CALLSIGN @ BBS REPLACEMENT.........................................121
  321.        DATABASE HELP........................................................122
  322.        HIERARCHICAL FORWARDING AND MSYS.....................................124
  323.          BULLETIN FORWARDING LOGIC..........................................126
  324.          CREATING THE BBSTONTS.BIN FILE.....................................128
  325.        HOUSECLEANING (HCL COMMAND)..........................................129
  326.          MSYS.HCL...........................................................129
  327.        MSYS NETWORK NODE INTRODUCTION.......................................131
  328.          ROUTING............................................................131
  329.          BASIC DECISIONS ABOUT THE NETWORK NODE.............................132
  330.          NETWORK NODE QUICKSTART............................................132
  331.          MANUAL OPERATIONS ON THE NETWORK NODE DATABASE.....................133
  332.          ONE POSSIBLE NETWORK NODE SETUP....................................134
  333.          NODE RELATED PARMS IN MSYS.DO......................................135
  334.          MISCELLANEOUS COMMENTS ON NETWORK NODE.............................137
  335.          NET NODE PARAMETERS SUMMARY........................................138
  336.        PACTOR...............................................................140
  337.        GTOR.................................................................140
  338.          OVERVIEW...........................................................140
  339.          HARDWARE...........................................................140
  340.          PACTOR/GTOR SET UP.................................................141
  341.          PACTOR TNC PARAMETERS..............................................141
  342.          PACTOR MANUAL CONNECTS.............................................142
  343.          GTOR MANUAL CONNECTS...............................................142
  344.          PACTOR FORWARDING..................................................143
  345.          GTOR FORWARDING....................................................143
  346.          USER'S VIEW WHEN CONNECTED.........................................144
  347.          PACTOR LIMITATIONS.................................................144
  348.          GTOR LIMITATIONS...................................................144
  349.          PACTOR TROUBLESHOOTING.............................................144
  350.          GTOR TROUBLESHOOTING...............................................144
  351.          MSYS PACTOR SCANNING...............................................144
  352.          MSYS GTOR SCANNING.................................................144
  353.  
  354.  
  355.        MSYS 1.18                                                   Page vi
  356.  
  357.  
  358.  
  359.  
  360.  
  361.          IOBUS.DOC..........................................................145
  362.          INTERRUPTS.........................................................145
  363.          ADDRESSING.........................................................145
  364.          DSR LINE...........................................................146
  365.          TTL TO RS-232 INTERFACE (1488/1489 VERSION)........................146
  366.          TTL TO RS-232 INTERFACE (MAX232)...................................147
  367.          SCANDEF UTILITY PROGRAM............................................149
  368.          TURNING IT ON AND OFF..............................................150
  369.          ADDING ANTENNAS....................................................151
  370.          THE LAST STEP, THE TSR.............................................152
  371.          USING OTHER RADIOS.................................................152
  372.        MSYS GENERAL INFORMATION.............................................153
  373.          BBS ONLY ACCESS....................................................153
  374.          CONNECTS FROM NON-AMATEUR CALLSIGNS................................153
  375.          #  COMMAND.........................................................153
  376.          CHANNEL NUMBERS....................................................153
  377.          DEVICE ERRORS......................................................153
  378.          DISK FULL MESSAGE..................................................153
  379.          DOS................................................................154
  380.          END OF LINE BELLS:.................................................154
  381.          EVENT.LOG..........................................................154
  382.          HEADERS............................................................154
  383.          KEYBOARD...........................................................154
  384.          ***LINKED..........................................................155
  385.          LOCKUPS............................................................155
  386.          MAIL BEACON........................................................155
  387.          MAIL.BAK...........................................................156
  388.          MAX CHANNELS AND PORTS.............................................156
  389.          MEMORY MANAGEMENT..................................................156
  390.          EXPANDED MEMORY USAGE..............................................157
  391.          AUTOMATIC MESSAGE HOLDING..........................................158
  392.          MSYS.DO............................................................160
  393.          MSYSTODO.DAT.......................................................160
  394.          MSYSTNC.#..........................................................161
  395.          SPECIAL KISS PARAMETERS............................................162
  396.          PACKET SIZE........................................................162
  397.          PASSWORDS..........................................................163
  398.          REMOTE SYSOP.......................................................163
  399.          AUTOMATIC PASSWORD REPLY...........................................164
  400.          USER PASSWORDS.....................................................164
  401.          THENET & NETROM RS-232 CONNECTIONS.................................165
  402.          SMTP...............................................................165
  403.          STACK REQUIREMENT..................................................166
  404.          TERM...............................................................166
  405.          TESTING............................................................166
  406.          TITLES TRUNCATED...................................................167
  407.          TYPE OF MESSAGE....................................................167
  408.          USER BIT SETTINGS:.................................................170
  409.          WP SERVER:.........................................................171
  410.          KANTRONICS 3.0 EPROM USERS:........................................171
  411.        FREQUENT PROBLEMS AND NOTES FROM THE AUTHOR..........................172
  412.          OVERRUNS, FRAMING ERRORS...........................................172
  413.          ABRUPT STOPS IN FORWARDING.........................................173
  414.  
  415.  
  416.        MSYS 1.18                                                   Page vii
  417.  
  418.  
  419.  
  420.  
  421.  
  422.          MESSAGES DON'T FORWARD.............................................173
  423.          THE SYSTEM FORWARDS MESSAGES TO IMPROPER LOCATIONS.................173
  424.          NOTHING IS ON THE SCREEN!..........................................173
  425.          THE SYSTEM COMES UP AND APPEARS TO HANG............................174
  426.          SYSTEM REBOOTS AFTER FORWARDING....................................174
  427.          INPUT BUFFER SPACE LOW.............................................174
  428.          PERFORMANCE HINTS..................................................174
  429.          DELETE OLD LOG FILES...............................................174
  430.          MFJ KISS MODE......................................................175
  431.          TIME...............................................................175
  432.          ADDITIONAL NOTES...................................................177
  433.          OS2 REPORTED PROBLEMS..............................................177
  434.        MSYS UTILITY SUPPORT PROGRAMS........................................179
  435.          MUTIL.EXE..........................................................179
  436.          MUTIL FUNCTION 1 - CHANGE MAX NUMBER OF MESSAGES...................180
  437.          MUTIL FUNCTION 2 - RESTORE MESSAGES................................181
  438.          MUTIL FUNCTION 3 - PRINT REMOTE SYSOP PHRASE.......................182
  439.          MUTIL FUNCTION 4 - CHECK MAIL INDEX FILE INTEGRITY.................183
  440.          MUTIL FUNCTION 5 - TEST SERIAL PORTS...............................184
  441.          MUTIL FUNCTION 6 - PRINT FORWARDING TREE...........................186
  442.          MUTIL FUNCTION 7 - CONVERT JNOS DOMAIN.TXT FILE TO MSYS FORMAT.....187
  443.          MUTIL FUNCTION 8 - RUN LOG FILE ANALYZER...........................188
  444.          MUTIL FUNCTION 9 - RUN SETUP PROGRAM...............................190
  445.          MUTIL FUNCTION 10 - SCAN MESSAGE HEADERS...........................191
  446.          MUTIL FUNCTION 11 - DELETES OLD ENTRIES............................192
  447.          MUTIL FUNCTION 12 - FIX MAIL INDEX FILE............................192
  448.          RENUMBERING MESSAGES...............................................193
  449.          MUTIL FUNCTION 13 - BBSLIST.DAT TO BBSTONTS.DAT....................194
  450.          MUTIL FUNCTION 14 - BBSTONTS.DAT TO BBSTONTS.BIN...................196
  451.          MUTIL FUNCTION 15 - BUILD LIST OF ARCHIVED MESSAGES................196
  452.          MUTIL FUNCTION 16 - PRINTER STATUS.................................197
  453.          MUTIL FUNCTION 17 - MERGE BBSLIST.DAT FILES........................197
  454.          MUTIL FUNCTION 18   CHECK MSYSNODE.DAT INTEGRITY...................197
  455.          MUTIL FUNCTION 19 - CONVERT USER FILES.............................197
  456.          MUTIL FUNCTION 20 - SORT BBSLIST.DAT FILE..........................197
  457.          MUTIL FUNCTION 21 - DELETE OLD BIDS (AND MIDS).....................198
  458.          MUTIL FUNCTION 22 - SPECIFY PRINTER FILE NAME......................198
  459.        SAMPLES OF MSYS FILES................................................199
  460.          MSYS.OPT:..........................................................199
  461.          MSYS.DO:...........................................................200
  462.          MSYS.OTD:..........................................................203
  463.          MSYSK.OTD..........................................................203
  464.          MSYS.REP:..........................................................203
  465.          MSYS.RMT:..........................................................204
  466.          MSYSBBSB.DAT:......................................................204
  467.          MSYSFWD.DEF:.......................................................205
  468.          MSYSHOST.NET:......................................................206
  469.          MSYSPASS.DAT:......................................................206
  470.          MSYSPASS.IP........................................................206
  471.          TYPICAL MSYSTNC.1..................................................207
  472.          (AEA PK-232).......................................................207
  473.        INFORMATION FOR ADVANCED USERS.......................................208
  474.          REPLACEABLE DIRECTORY NAMES........................................208
  475.  
  476.  
  477.        MSYS 1.18                                                   Page viii
  478.  
  479.  
  480.  
  481.  
  482.  
  483.          REPLACEABLE FILE NAMES.............................................209
  484.          MSYS MSG FILE FORMAT:(FOR THE ADVENTURESOME ONLY!).................211
  485.          ROUTES.DAT FILE FORMAT:............................................212
  486.          MSYS UNDER WINDOWS 3.1.............................................213
  487.          MSYS UNDER DESQVIEW................................................214
  488.          SYSOP COMMANDS RELATED TO TCP/IP...................................216
  489.          FILES RELATED TO TCP/IP............................................217
  490.          USER ACCESS LEVEL CHART............................................219
  491.          FTP COMMANDS:......................................................219
  492.          IP ROUTING:........................................................220
  493.          EDITVIEW (ED COMMAND)..............................................221
  494.          EDITFILE (EF COMMAND)..............................................222
  495.          EPILOG.............................................................225
  496.        INDEX................................................................226
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.        MSYS 1.18                                                   Page ix
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.                              MSYS INITIAL INSTALLATION
  546.                        Copyright 1994 by HUB COMPUTERS, INC.
  547.  
  548.        1. Installation of MSYS is not particularly difficult but you should
  549.           follow the following steps in order.
  550.  
  551.        2. If you are upgrading from MSYS 1.17, please see the UPDATE
  552.           Instructions.
  553.  
  554.        3. Make a backup copy of the distribution disk.  You can copy the
  555.           entire disk with Diskcopy.
  556.  
  557.        4. Make a default directory on your hard disk.  I call mine MSYS.
  558.           Use the command:
  559.             md c:\msys
  560.  
  561.        5. NOTE: You may use any drive letter.  All references to the C:
  562.           drive apply to your selected drive.
  563.  
  564.        6. Go to the default directory: cd c:\msys.
  565.  
  566.        7. Make required sub directories:
  567.                md c:\msys\mail
  568.                md c:\msys\files
  569.                md c:\msys\help
  570.                md c:\msys\mail.bak
  571.                md c:\msys\mail.bin
  572.  
  573.        8. Move the file MSYS118.exe into the c:\MSYS directory
  574.  
  575.        9. Un-arc the distribution disk by running the program MSYS118.EXE.
  576.  
  577.        10.To move the help files to the help sub-directory.  Type MOVEFILE
  578.  
  579.        11.NOTE:  REQUIRED FILE:  C:\MSYS\HELP\MSYSMSGS.DAT
  580.           This file contains a number of the messages used by MSYS.
  581.  
  582.        12.Change Directory to SAMPLES.  Edit the file
  583.           C:\MSYS\SAMPLES\MSYS.OPT with your favorite program editor.  See
  584.           documentation on MSYS.OPT for details.  After editing move
  585.           MSYS.OPT file to the default directory.
  586.  
  587.        13.RUN MUTIL.EXE Function 9 to create C:\MSYS\MSYS.DEF from your
  588.           edited MSYS.OPT
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.        MSYS 1.18                                                   Page 1
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.        14.Make sure you have at least:
  607.  
  608.                files=40
  609.                buffers=20
  610.           in your config.sys file in the root directory of your boot disk.
  611.           Don't forget to reboot after changing this!
  612.  
  613.        15.Using any ASCII editor, create MSYSFWD.DEF.  If you don't know
  614.           what to put it in now, put the following (to be replaced later):
  615.  
  616.                F0 WA8BXN
  617.                WA8BXN
  618.                -----
  619.  
  620.        16.Type MSYS and it should begin to run!
  621.  
  622.        17.Type MERge. You can ignore any messages about MSYSBBSB.DAT at
  623.           this time.
  624.  
  625.           SPECIAL NOTE
  626.           If you have a color monitor or any kind of a color card, the
  627.           default is OK.  If you have a monochrome monitor that uses and
  628.           RCA phono pin plug then you are using a Color Graphics Adapter
  629.           interface card and the default should be OK.  If you can do the
  630.           command MODE MONO (this is a DOS command) and not get any error
  631.           messages and the computer continues to work, you probably have a
  632.           monochrome (TTL) interface card.  You will need to specify WINDOW
  633.           DISPLAY MONOCHROME in the MSYS.OPT file.
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.        MSYS 1.18                                                   Page 2
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.                        MSYS UPDATE INSTALLATION INSTRUCTIONS
  668.  
  669.                                    SETUP CHANGES
  670.  
  671.        There are two new directories that are required to update MSYS Ver.
  672.        1.13 to Ver. 1.18  One is the MSYS\MAIL.BIN directory that is used to
  673.        store the compressed messages as they are received and sent, and the
  674.        other is MSYS\YAPP which is used to store files that have been
  675.        transferred via YAPP compressed protocol.  Please see the MSYS
  676.        DIRECTORY LAYOUT DESCRIPTION for further details.  Use DOS commands
  677.        to make the new sub-directories.  If you are already running MSYS
  678.        1.15, no further changes need to be made in the directory structure.
  679.  
  680.        Increase your FILES statement in CONFIG.SYS to files=40.  BUFFERS can
  681.        remain at 20.
  682.  
  683.        It is suggested that a program similar to the Quarterdeck Systems:
  684.        VIDRAM ON be run prior to running MSYS to create as much working
  685.        memory as possible.  MSYS does not require graphics capability.  Of
  686.        course, if other background applications require graphics, this
  687.        option is not available.  VIDRAM works with EGA or VGA video
  688.        adapters, and should not be loaded into upper memory.
  689.  
  690.        Run MUTIL 9 (setup) and of course, MUTIL 4 before restarting the new
  691.        version of MSYS.
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.        MSYS 1.18                                                   Page 3
  722.  
  723.  
  724.  
  725.  
  726.  
  727.                                 ADDITIONS & CHANGES
  728.  
  729.        There have been many changes to MSYS, some major and many minor.
  730.        Here are some of the changes:
  731.  
  732.        1. One of the major changes in Ver. 1.18 is the addition of G-TOR.
  733.            MSYS properly interfaces a KAM Plus that has the proper firmware
  734.            installed.
  735.        2. "Attended" G-TOR forwarding on HF can be initiated from the
  736.            keyboard at the same time VHF forwarding is in progress.
  737.        3. Scanning of HF radios is supported in the G-TOR mode.
  738.        4.  A new command SHUtdown has been added.  When on, it prevents new
  739.            incoming connects, and advises current users of impending shut
  740.            down.
  741.        5.  A new command VAlidmsgtypes which takes a string of letters as
  742.            its arguments that may follow S in send commands in the bbs.
  743.            Defaults are BTPW.  This should prevent type "SR" and related
  744.            problems.
  745.        6.  A SE- chan# text command has been added which will send the given
  746.            text without the usual "Msg from sysop" prefix.
  747.        7.  Regenerated messages are now stored in the mail.bak directory.
  748.        8.  The CONFERENCE is no longer accessible from the modem.
  749.        9.  The bug in MAXBullage has been resolved.
  750.        10. The LU RESET bug has been fixed.
  751.        11. The sysop commands K< and K> have been implemented.
  752.        12. The "TO" call, the "FROM" call and the "@BBS" are now also
  753.            compared with the bad word file if it is used.
  754.        13. Changes have been made in the forwarding syntax to partially
  755.            accommodate the misguided useage of specific hierarchical
  756.            components as flood routes, such as USA instead of ALLUS
  757.        14. If a message disappears during forwarding, (from housecleaning or
  758.            manual deletion), the forwarding connection will now be
  759.            terminated.
  760.        15. If a message is refused by a FBB station with the FS = response,
  761.            the message will be held for sysop evaluation.
  762.        16. Bulletins that have the same titles as active bulletins from the
  763.            same callsign will be held for sysop review for duplication.
  764.        17. Bulletins that have an apparent BID change based on the R: lines
  765.            will be held for sysop review for duplication.
  766.        18. Users will have the opportunity to delete a replied to message.
  767.        19. Sysops may kill any read message as well as reply to them with a
  768.            "k" response if autoreply is enabled.
  769.        20. MSYS will do an automatic MERGE at the initial startup.  It will
  770.            not do a merge if forwarding is in progress, but will initiate
  771.            one at the beginning of the next forward cycle.
  772.        21. A command RTime has been added to enable the proper reporting of
  773.            "Z" time in the R: line while running local time in the bbs.
  774.        22. Restored messages are now also stored in the mail.bak directory.
  775.        23. MUTIL 7 has been added to convert JNOS-style domain.txt files to
  776.            MSYSHOST.NET format.  The file will still need editing to add
  777.            aliases, but is does save a lot of retyping.
  778.  
  779.  
  780.  
  781.  
  782.        MSYS 1.18                                                   Page 4
  783.  
  784.  
  785.  
  786.  
  787.  
  788.                          KNOWN PROBLEMS WITH THIS RELEASE
  789.  
  790.        The author is aware of several problems with this release that may be
  791.        addressed in future releases as time permits.
  792.  
  793.        One concerns FTP sessions between JNOS and MSYS.  The sessions do not
  794.        conclude properly.  The temporary fix is for you to manually
  795.        disconnect the data channel session.
  796.  
  797.        A second problem can occur when a message has come into a MSYS system
  798.        with "garbage" characters, generally via a FBB or a telephone modem
  799.        forwarding session, and if the first and only character of a line
  800.        happens to be a control A.  If that message is then forwarded out
  801.        using RLI protocol, the forward session will abort.  The obvious cure
  802.        is for sysops to review, and edit as necessary, messages that contain
  803.        extraneous characters.  FBB-style forwarding generally is not
  804.        affected by this problem.
  805.  
  806.        If you find a problem not listed above, please document as carefully
  807.        as possible, outlining all the conditions that can cause the problem
  808.        before advising the author.  Of course, the condition must be
  809.        repeatable for it to be found.  Messages that say:  "It doesn't work"
  810.        are not helpful.  Likewise, if you find errors in the documentation,
  811.        please advise so that proper changes can be made.  Thankyou for your
  812.        cooperation.
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.        MSYS 1.18                                                   Page 5
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.                                  MSYS COMMAND LINE
  851.  
  852.        The MSYS command typed at the DOS prompt may have several switches or
  853.        modifiers.
  854.  
  855.             NOHEARD   Disables JK,JM,JD,JG,JB and JT recording.  Saves
  856.                       26,880 bytes
  857.             NONODE    Disables network node, saves 28,104 bytes
  858.             NORAMHDRS Stores message headers on disk only, saves 136 bytes
  859.                       per possible message.  This can be quite slow if you
  860.                       have lots of msgs and no disk cache. Could be useful
  861.                       on 286 systems with cache in EXTENDED memory.
  862.             NOEMM     Disables Expanded Memory.
  863.             NOEXMEM   Disables Extended Memory.
  864.  
  865.  
  866.        Example:
  867.  
  868.             MSYS NOHEARD    Starts MSYS but will not log any stations it
  869.                              hears.
  870.             MSYS NONODE     Starts MSYS without the NETNODe feature.
  871.             MSYS NORAMHDRS  Starts MSYS and stores all headers on disk - not
  872.                              in RAM
  873.             MSYS NOEMM      Starts MSYS and forces MSYS to use EXTENDED
  874.                              memory   (if any).
  875.             MSYS            Starts MSYS, permitting it to use EXPANDED
  876.                              memory, (if any) and all other features that
  877.                              have been optioned.
  878.  
  879.        MSYS has the ability to determine if there is an EXTENDED or EXPANDED
  880.        memory manager in use.  It will attempt to use the EXPANDED memory
  881.        unless the NOEMM option is specified, in which case it will attempt
  882.        to use the EXTENDED memory.  MSYS now requires about 2 MBytes of
  883.        upper memory.
  884.  
  885.        While MSYS may be run on an 8088 or 8086 system, much better
  886.        performance will be achieved by using a 286 or higher system.
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.        MSYS 1.18                                                   Page 6
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.                              ABBREVIATIONS/CONVENTIONS
  912.  
  913.        Just a word about this manual.  Most commands are not case sensitive,
  914.        with the notable exception of the \Sysop command.  Many commands may
  915.        be abbreviated.  In this manual, we have attempted to show the
  916.        minimum abbreviation with the UPPER CASE letters with the balance of
  917.        the command word in lower case.  For example, the command ADDUser may
  918.        be typed as:  addu  or  ADDU  or  adduser  or  ADDUSER  with the same
  919.        results.  Where there is an argument shown as [on/OFF], the UPPER
  920.        CASE will be the default.  For example, in the case of the command
  921.        PC [on/OFF],  the call server lookup defaults to OFF.
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.        MSYS 1.18                                                   Page 7
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.                          MSYS DIRECTORY LAYOUT DESCRIPTION
  973.  
  974.  
  975.        The following chart is the recommended organization for your
  976.        directories and files.  NOTE: Some of these files are created at time
  977.        of installation and others are operating files that MSYS creates
  978.        while operating.
  979.  
  980.        C:\MSYS   Contains all of the MSYS operating programs and 
  981.          |       configuration files
  982.          |  MSYS.EXE $     MSYS.MSG #      BIDLIST.DAT #  MSYSPASS.IP @
  983.          |  MUTIL.EXE $    MSYS.BBS #      MSYSPASS.MOD @ MSYSPASS.DAT @
  984.          |  ROUTES.DAT $   MSYS.DEF #      MSYSBBSB.DAT @ MSYS.HCL @
  985.          |  STATES.DAT $   MSYS.FWD #      MSYSTODO.DAT @ MSYSHCL.DO @
  986.          |  ZIPCODES.DAT $ MSYS.HRD #      MSYSHOLD.DAT @ MSYS.OPT @
  987.          |  CALLSRV3.EXE $ MSYS.LOG #      MSYSFWD.DEF @  MSYS.OTD @
  988.          |  MSYS.BBS #     MSYS.USR #      MSYSHOST.NET @ MSYS.REP @
  989.          |  BBSTONTS.BIN # MSYSNODE.DAT #  BADWORDS.DAT @ MSYS.RMT @
  990.          |  BBSTONTS.DAT # MSGLIST.DAT #   MSYSTNC.1 @    MSYS.DO @
  991.          |       Files marked with a: $ are Distribution files.
  992.          |                            # are created by MUTIL or MSYS
  993.          |                            @ are SYSOP created files
  994.          |
  995.          |--------FWD
  996.          |   Directory which may contain forwarding files (.FWD)
  997.          |   the reverse forwarding  files (.REV) and the
  998.          |   PASSWORD.RMT file and is used by MERge command
  999.          |
  1000.          |--------HELP
  1001.          |   Directory which contains HELP messages including
  1002.          |   MSYSMSGS.DAT
  1003.          |
  1004.          |--------MAIL
  1005.          |   Directory which contains ACTIVE messages
  1006.          |
  1007.          |--------MAIL.BAK ***Optional
  1008.          |   Directory which may contain BACKUP messages  See ADVANCED
  1009.          |   USER section for suggestion!
  1010.          |
  1011.          |
  1012.          |
  1013.          |       (continued next page)
  1014.          |
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.        MSYS 1.18                                                   Page 8
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.          |
  1033.          |       (continued from previous page)
  1034.          |
  1035.          |--------MAIL.BIN
  1036.          |   Directory which contains COMPRESSED messages
  1037.          |
  1038.          |--------PASSWORD ***Optional
  1039.          |   Directory which may contain user PASSWORD files
  1040.          |
  1041.          |--------PUBLIC   ***Optional
  1042.          |   Directory which may contain uploaded FTP/SMTP messages
  1043.          |
  1044.          |--------YAPP     ***Optional
  1045.          |   Directory which may contain YAPP files
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.        MSYS 1.18                                                   Page 9
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.                                      MSYS.OPT
  1094.  
  1095.  
  1096.        Before MSYS can be used a configuration file (MSYS.OPT) must be
  1097.        created and the program SETUP (MUTIL.EXE Function 9) must be run to
  1098.        create the file MSYS.DEF. The file MSYS.OPT is a  standard ASCII file
  1099.        and may be created with any text editor.  The basic format of the
  1100.        commands in the file are:
  1101.  
  1102.        PORT number AT number INT number SPEED number [NAME description]
  1103.        PORT number SUBPORT number OF [PORT] number [NAME description]
  1104.        DIGI callsign FROM [PORT] number TO [PORT] number [AS callsign]
  1105.        NUMCHANS number
  1106.        BBS CALL callsign
  1107.        BBS ALIAS callsign
  1108.        KANODe CALL callsign
  1109.        ANSWER CALL callsign
  1110.        FORWARD CALL callsign
  1111.        ID CALL callsign
  1112.        ID EVERY number
  1113.        AX25 FRACK number
  1114.        AX25 MAXFRAMES number
  1115.        AX25 RETRIES number
  1116.        AX25 CHECK number
  1117.        MONITOR IFRAMES on/off
  1118.        MONITOR UFRAMES on/off
  1119.        MONITOR SFRAMES on/off
  1120.        MONITOR BFRAMES on/off
  1121.        MONITOR OUTGOING on/off
  1122.        MONITOR PORTS [MASK]
  1123.        WINDOW number SIZE number number number number
  1124.        WINDOW number BACKGROUND number
  1125.        WINDOW number FOREGROUND number
  1126.        WINDOW number PAGE number
  1127.        WINDOW UNUSED BACKGROUND number
  1128.        WINDOW UNUSED FOREGROUND number
  1129.        WINDOW DISPLAY color/monochrome
  1130.        PROCESS processname [WINDOW] number
  1131.        STACK processname number ***NOT USED IF USING EXT/EXP MEMORY
  1132.                                   (SEE TEXT)
  1133.        SYSOP NAME name
  1134.        SYSOP QTH location
  1135.        SYSOP ZIP zip code
  1136.        MAKE
  1137.        --------------------------------
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.        MSYS 1.18                                                   Page 10
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.        Notes:
  1155.             1.Items enclosed in square brackets ([...]) are optional
  1156.             2.Numbers assumed in decimal unless prefixed by $ then hex is
  1157.               assumed
  1158.             3.on/off means the word ON or OFF
  1159.             4.Where more than 1 space is shown, 1 or more space are OK
  1160.             5.Callsign can include SSID (-number)
  1161.             6.Ordering of the statements is generally not important
  1162.             7.If there is an * at the beginning of a line it is ignored
  1163.             8.The BBS alias, KANODe, Answer and Forward calls must be
  1164.               different calls or SSID's.
  1165.             9.MASK is described on page 24
  1166.  
  1167.        Output from the execution of SETUP is the file MSYS.DEF (a binary
  1168.        file) and a listing to the display console.  The listing consists of
  1169.        two parts: the original input statements followed by a complete list
  1170.        of all options generated (including defaults).
  1171.  
  1172.        If any errors are detected, the MSYS.DEF file will not be created.
  1173.  
  1174.        A sample of a MSYS.OPT file is found in MSYS.OPT on the distribution
  1175.        disk.
  1176.  
  1177.        A minimal MSYS.OPT file will have similar statements to these:
  1178.  
  1179.             port 0 at $3F8 int 4 speed 1200 name 145.01
  1180.             bbs call wa8bxn-13
  1181.             answer  call wa8bxn-14
  1182.             sysop name Mike
  1183.             sysop qth Kirtland, OH
  1184.             sysop zip 44094
  1185.             id call wa8bxn
  1186.             make
  1187.  
  1188.                         EXPLANATION OF EACH STATEMENT TYPE
  1189.  
  1190.        PORT number at number INT number SPEED number [NAME Description]
  1191.        [RADIOSPEED #][TNCtype#]   (ALL ON ONE LINE!)
  1192.        PORT number SUBPORT number OF [PORT] number [NAME description]
  1193.  
  1194.        The PORT statement has the above two variations.  The number
  1195.        following the word PORT is the port number.  It must be between 0 and
  1196.        6.  The version containing the word 'at' defines an actual serial
  1197.        interface, while the SUBPORT version defines a second logical port
  1198.        for multiport TNCs such as the KPC-4.  There must  be one PORT
  1199.        statement for each RADIO port to be used AND each MODEM port to be
  1200.        used.
  1201.  
  1202.        Assign port numbers beginning with 0 in increments of 1.
  1203.  
  1204.        Following the word AT is the base I/O address of the serial port,
  1205.        such as $3F8.  Following the word  INT is the interrupt number for
  1206.        the serial port, such as 4.
  1207.  
  1208.  
  1209.        MSYS 1.18                                                   Page 11
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.        After SPEED is the baud rate to be used, such as 4800.  This is the
  1217.        speed between the computer and the TNC or the MODEM.  It is STRONGLY
  1218.        suggested that with faster modems that a value of 19200 be used to
  1219.        prevent buffer overruns.  Some adjustment of this speed may be
  1220.        necessary to avoid overruns on a per port basis.
  1221.  
  1222.        Optionally the word NAME followed by some description of the port can
  1223.        be given. A good description would be the corresponding radio
  1224.        frequency.
  1225.  
  1226.        If MSYS is interfacing a NET/ROM matrix, or a TNC using the NetRom
  1227.        Serial protocol (NRS), precede the NAME with a ">"  as in:  >MATRIX
  1228.  
  1229.        If MSYS is interfacing a modem, the NAME must be: MODEM
  1230.  
  1231.        If MSYS is interfacing a PACTOR or GTOR tnc, the NAME must begin
  1232.        with: PACTOR or GTOR.  You may choose to name it PACTOR_20M or
  1233.        GTOR_20M for better description.  The name must not exceed 10
  1234.        Characters total.
  1235.  
  1236.  
  1237.        For the other form of the PORT statement, the number following the
  1238.        word SUBPORT is the logical channel number, typically 1 for the KPC-
  1239.        4.  Next comes the word  OF  in the statement optionally followed by
  1240.        the word PORT.  Next comes the port number of a port statement
  1241.        defining an actual port (i.e., contains  the word AT in its
  1242.        definition).  The optional NAME and description is the same as above.
  1243.  
  1244.        PORT description lines can also have two additional parameters:
  1245.  
  1246.          RADIOSPEED bitrate# TNCTYPE #
  1247.  
  1248.        RADIOSPEED specifies the bitrate used by the TNC to the radio (300 or
  1249.        1200 probably).  If 300 bps is selected, shortened prompts are used
  1250.        in the BBS and perhaps elsewhere.
  1251.  
  1252.        TNCTYPE  is a number from 0 to 999.  TNC type 0 is a KPC-x or a KAM.
  1253.        Any other number causes a file MSYSTNC.# to be read for
  1254.        initialization statements to be sent to the TNC.  These parameters
  1255.        would be used for a TNC other than a KPC-X or a KAM, or for the file
  1256.        to initialize a modem..
  1257.  
  1258.        NOTE: You must specify RADIOSPEED if you use TNCTYPE#
  1259.  
  1260.        For example:
  1261.  
  1262.         PORT 2 AT $2F8 INT3 SPEED 4800 NAME 145.01 RADIOSPEED 1200 TNCTYPE 1
  1263.  
  1264.        IN THE MSYSTNC.1 FILE YOU WOULD HAVE THE COMMANDS THAT  WOULD
  1265.        PUT YOUR TNC INTO KISS MODE. (see note in general info section)
  1266.  
  1267.          DIGI callsign FROM [PORT] number TO [PORT] number [AS callsign]
  1268.  
  1269.  
  1270.        MSYS 1.18                                                   Page 12
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.        The DIGI statement defines a digipeater callsign.  Repeat this
  1278.        statement type up to a total of 25 times as desired.  The first
  1279.        callsign is the callsign that would be used in the VIA list by a
  1280.        station trying to use the digipeater.  The port number following FROM
  1281.        indicates the port that will be using this call.  The TO port number
  1282.        indicated the port on which packets having this the first callsign as
  1283.        digipeater should be output on.  For a normal digipeater the two port
  1284.        numbers will be the same;  for a gateway they will be different.  The
  1285.        optional AS callsign specifies a replacement for the first callsign
  1286.        in the digipeater list when the packet is sent out the TO port.  If
  1287.        omitted the first callsign is assumed (i.e., no change).  Consider
  1288.        the following examples:
  1289.          DIGI MYDIGI FROM 0 TO 0
  1290.          DIGI MYDIGI FROM 1 TO 1
  1291.          DIGI W1XX-3 FROM 0 to 0
  1292.  
  1293.        This would allow the callsign MYDIGI to be used in the via list on
  1294.        either port 0 or 1.  The packet is retransmitted on the same port was
  1295.        heard on.  The call W1XX-3 can also be used to digipeat on port 0.
  1296.  
  1297.          DIGI MYGATE FROM 0 TO 1
  1298.          DIGI MYGATE FROM 1 TO 0
  1299.  
  1300.        This pair would define a gateway between ports 0 and 1 with the
  1301.        callsign MYGATE used in both directions.
  1302.  
  1303.          DIGI TOF1 FROM 0 TO 1 AS TOF2
  1304.          DIGI TOF2 FROM 1 TO 0 AS TOF1
  1305.  
  1306.        This interesting pair allows TOF1 to be used as a gateway digipeater
  1307.        call on port 0 (no effect if used on port 1).  When the packet is
  1308.        repeated it will have TOF2 in the digipeater list where TOF1
  1309.        originally was.  The opposite is true on port 1: When TOF2 is used as
  1310.        a digipeater call the packet is repeated on port 0 with
  1311.        TOF1 being substituted for TOF2.  The substitution is transparent to
  1312.        the users.
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.        MSYS 1.18                                                   Page 13
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.          NUMCHANS number
  1339.  
  1340.        NUMCHANS is used to specify the number of logical channels that will
  1341.        be allocated.  Each connection (while connected) uses one logical
  1342.        channel.  When the KANODe is being used a second logical channel is
  1343.        used for outgoing connects.  Each logical channel requires about 7K
  1344.        of memory when in use.  They are available for reuse when a station
  1345.        disconnects.
  1346.  
  1347.          BBS CALL callsign
  1348.  
  1349.        This statement gives the callsign that can be connected to for the
  1350.        BBS.  The callsign can contain an SSID.  This statement is also
  1351.        optional; if omitted stations will not be able to connect to the BBS
  1352.        unless a BBS alias is given.
  1353.  
  1354.  
  1355.          BBS ALIAS callsign
  1356.  
  1357.        This statement gives the callsign that can be connected to for the
  1358.        BBS.  The callsign can contain an SSID.  This statement is also
  1359.        optional; if omitted stations will not be able to connect to the BBS
  1360.        unless a BBS CALL is given.
  1361.  
  1362.  
  1363.          KANODE CALL callsign
  1364.  
  1365.        This statement gives the callsign of the KANODe which is similar to
  1366.        the KANODe provided in the Kantronics tncs.  The callsign can (and
  1367.        probably should) contain an SSID.  This statement is optional; if
  1368.        omitted stations will not be able to connect to the KANODe.
  1369.  
  1370.          ANSWER CALL callsign
  1371.  
  1372.        This statement gives the callsign that can be connected to by
  1373.        stations wanting to talk to the SYSOP.  It is also used as the
  1374.        callsign when the Connect command is used.  The callsign can (and
  1375.        maybe should) contain an SSID.  This statement should not be omitted.
  1376.  
  1377.  
  1378.          FORWARD CALL callsign
  1379.  
  1380.        This statement gives the callsign used when the BBS is forwarding.
  1381.        It can (and probably should) contain and SSID.  This statement should
  1382.        not be omitted if the BBS is to do forwarding.
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.        MSYS 1.18                                                   Page 14
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.          ID CALL callsign
  1399.  
  1400.        This statement gives the callsign that will be used for
  1401.        identification purposes.  It must be your actual amateur callsign and
  1402.        should NOT have an SSID specified.  This statement MUST be used.
  1403.  
  1404.  
  1405.          ID EVERY number
  1406.  
  1407.        This statement specifies the number of minutes between IDs.  The list
  1408.        of stations for which there is mail is generated with every ID.
  1409.  
  1410.  
  1411.          AX25 FRACK number
  1412.  
  1413.        Number is the number of seconds to wait before retransmitting a
  1414.        packet.  All of the AX25 statement forms are
  1415.        optional.
  1416.  
  1417.  
  1418.          AX25 MAXFRAMES number
  1419.  
  1420.        Number specifies the maximum number of frames that can be outstanding
  1421.        before waiting for an ACK.  Must be between 1 and 7.
  1422.  
  1423.          AX25 RETRIES number
  1424.  
  1425.        This is the number of retries that will be made before abandoning a
  1426.        connection.
  1427.  
  1428.  
  1429.          AX25 CHECK number
  1430.  
  1431.        If there is no activity on a logical channel for this number of
  1432.        seconds there will be an automatic disconnect.
  1433.  
  1434.  
  1435.          MONITOR IFRAMES on/off
  1436.  
  1437.        Turns on or off the displaying of Information frames (SABM, DISC,
  1438.        UA).  All forms of the MONITOR statement are optional.
  1439.  
  1440.  
  1441.          MONITOR SFRAMES on/off
  1442.  
  1443.        Turns on or off the displaying of System (RR, RNR, REJ) frames.
  1444.  
  1445.  
  1446.          MONITOR BFRAMES on/off
  1447.  
  1448.        Turns on or off the displaying of Beacon frames (Un-numbered
  1449.        information).
  1450.  
  1451.  
  1452.  
  1453.        MSYS 1.18                                                   Page 15
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.          MONITOR OUTGOING on/off
  1461.  
  1462.        Turns on or off the displaying of all outgoing packets.
  1463.  
  1464.  
  1465.          MONITOR PORTS  [MASK]
  1466.  
  1467.        Determines which ports will be monitored.  The rightmost bit of this
  1468.        number corresponds to port 0, the next bit to the left port 1 and so
  1469.        on.  Ports with 1 bits are displayed (as selected above).  A value of
  1470.        13 (decimal, $D in hex) would enable ports 0, 2 and 3, for example.
  1471.  
  1472.        SEE MASK on page 20 for further details.
  1473.  
  1474.  
  1475.          WINDOW number SIZE number number number number
  1476.  
  1477.        This form of the window statement gives the bounds of the window
  1478.        whose number is given after the word WINDOW.  The four numbers after
  1479.        the word SIZE are the upper left column (1 to 80), the upper left row
  1480.        (1 to 25), the lower right column, and the lower right row
  1481.        respectively.  All of the WINDOW statement forms are optional and
  1482.        should be used with great caution.
  1483.  
  1484.          WINDOW number BACKGROUND number
  1485.          WINDOW number FOREGROUND number
  1486.  
  1487.        These two forms of the WINDOW statement give the background and
  1488.        foreground colors of the window specified after the word WINDOW.  The
  1489.        rightmost number is a color number from 0 to 15 for foregrounds and 0
  1490.        to 7 for backgrounds.  The corresponding colors are:
  1491.  
  1492.        Black - 0               Magenta - 5              Lt. Cyan - 11
  1493.        Blue - 1                Brown - 6                Lt. Red - 12
  1494.        Green - 2               Lt. Gray - 7             Lt. Mag - 13
  1495.        Cyan - 3                Gray - 8                 Yellow - 14
  1496.        Red - 4                 Lt. Blue - 9             White - 15
  1497.                                Lt. Green - 10
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.        MSYS 1.18                                                   Page 16
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.          WINDOW number PAGE number
  1522.  
  1523.        This statement assigns a window to the specified page (0-3) which
  1524.        corresponds to the F1, F2, F3, and F4 keys.
  1525.  
  1526.          WINDOW UNUSED BACKGROUND number
  1527.          WINDOW UNUSED FOREGROUND number
  1528.  
  1529.        These two statements give background and foreground colors to the
  1530.        places on the screen not assigned to any window.
  1531.  
  1532.          WINDOW DISPLAY  color/monochrome
  1533.  
  1534.        This statement selects the kind of display adapter you have, COLOR or
  1535.        MONOCHROME.  If you have a CGA card, select COLOR.
  1536.  
  1537.  
  1538.          PROCESS processname [WINDOW] number
  1539.  
  1540.        This statement specifies the window that is to be used for output
  1541.        from the allowable process names .  Be extremely careful if you use
  1542.        this statement.
  1543.  
  1544.          STACK processname number
  1545.  
  1546.        This statement specifies the number of bytes to be allocated for the
  1547.        stack for the allowable process names .  You probably shouldn't mess
  1548.        with the defaults!  ***THIS OPTION IS IGNORED ON A 286/386 equipped
  1549.        with EMM or EMS.
  1550.  
  1551.        DISCUSSION:
  1552.  
  1553.        First, if using extended or expanded memory, you have no control over
  1554.        stack size, they are all 16K. Only when just 640K (or less if that is
  1555.        possible) regular memory alone is used can adjustments be made to
  1556.        stack sizes.  Normally these should not be necessary.  The default
  1557.        values set by MUTIL 9 should be correct.  This means that normally
  1558.        there should be no process stack statements in MSYS.OPT.
  1559.  
  1560.        How to tell when you need to adjust stack sizes --- If you get
  1561.        unexpected crashes that can't be solved by other means, do somewhat
  1562.        frequent process commands when conditions are similar to when crashes
  1563.        occur (like when lots of channels are in use, when forwarding is
  1564.        happening, etc.). If the SPmin value for any process gets below a few
  1565.        hundred an increase in the stack allocation for that kind of process
  1566.        may be needed.  In the event SPmin goes to 0 or negative, an
  1567.        adjustment is required.
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.        MSYS 1.18                                                   Page 17
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.        How to adjust stack sizes --- Get a printed copy of the output from
  1582.        MUTIL 9. You will see there a list of the process type names and
  1583.        current stack sizes for each.  Add a process stack line in MSYS.OPT
  1584.        for the one you need to increase. Any increases should probably be
  1585.        done in 1K increments.
  1586.  
  1587.        Stack sizes should probably not be adjust downward greatly from the
  1588.        default values even though it appears on most process command lists
  1589.        that the SPmin is always very high. How much stack space is needed is
  1590.        dependent on the particular activities that are occurring.  Values
  1591.        that appear excessive may be required for infrequently performed
  1592.        operations that if done with small stacks would result in
  1593.        unpredictable results. (Can you say "CRASH"?  How about "HANG"?)
  1594.  
  1595.          SYSOP NAME name
  1596.  
  1597.        You must use this statement to specify your first name.
  1598.  
  1599.          SYSOP QTH location
  1600.  
  1601.        You must use this statement to specify your location.
  1602.  
  1603.          SYSOP ZIP postal code
  1604.  
  1605.        You must use this statement to specify your zip or postal code.
  1606.  
  1607.          MAKE
  1608.  
  1609.        Use this statement if you want to produce the new MSYS.DEF file if
  1610.        there are no errors.
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.        MSYS 1.18                                                   Page 18
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.        Here is a sample MSYS.OPT file for you to figure out!
  1644.  
  1645.        port 1 at $3e8 int 4 speed 1200 name 223.70
  1646.        port 0 at $2f8 int 3 speed 1200 name 145.01
  1647.        digi bxng from 0 to 0 as bxng
  1648.        digi bxng from 1 to 1 as bxng
  1649.        digi bxn501 from 0 to 0 as bxn501
  1650.        digi bxn501 from 1 to 0 as bxn370
  1651.        digi bxn370 from 0 to 1 as bxn501
  1652.        digi bxn370 from port 1 to port 1 as bxn370
  1653.        digi test-4 from port 0 to port 1 as test-5
  1654.        digi wa8bxn-3 from 0 to 0
  1655.        bbs call wa8bxn-13
  1656.        kanode call wa8bxn-1
  1657.        answer  call wa8bxn-14
  1658.        forward call wa8bxn-12
  1659.        sysop name Mike
  1660.        sysop qth Kirtland, OH
  1661.        sysop zip 44026
  1662.        id call wa8bxn
  1663.        window display color
  1664.        make
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.        MSYS 1.18                                                   Page 19
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.                                  MASK INFORMATION
  1704.  
  1705.        Several commands require the use of a MASK to determine the exact
  1706.        ports you wish to perform the function.  For example, you.  You may
  1707.        wish to only permit NetRom connects on port 2, or you may wish to
  1708.        have bbs connects only on port 3, or you may wish to monitor only
  1709.        ports 2 , 3 and 8 on the F2 screen.  The MASK is merely a hexadecimal
  1710.        representation of the ports.  The BIT PATTERN CHART is the way to
  1711.        determine what the MASK value will be.
  1712.  
  1713.                                  BIT PATTERN CHART
  1714.             To be used for DPorts, KPorts, MONPorts, NPorts and TPorts
  1715.  
  1716.  
  1717.        MASK VALUE         PORT NUMBER          CONDITION
  1718.  
  1719.                  6    5    4    3    2    1    0    1=ON, 0=OFF
  1720.  
  1721.             0    0    0    0    0    0    0    0    All Off
  1722.             1    0    0    0    0    0    0    1    0 - ON
  1723.             2    0    0    0    0    0    1    0    1 - ON
  1724.             3    0    0    0    0    0    1    1    1,0 - ON
  1725.             4    0    0    0    0    1    0    0    2 - ON
  1726.             5    0    0    0    0    1    0    1    0,2 - ON
  1727.             6    0    0    0    0    1    1    0    2,1 - ON
  1728.             7    0    0    0    0    1    1    1    0,1,2 - ON
  1729.             8    0    0    0    1    0    0    0    3 - ON
  1730.             9    0    0    0    1    0    0    1    3,0 - ON
  1731.             A    0    0    0    1    0    1    0    3,1 - ON
  1732.             B    0    0    0    1    0    1    1    0,1,3 - ON
  1733.             C    0    0    0    1    1    0    0    3,2 - ON
  1734.             D    0    0    0    1    1    0    1    0,2,3 - ON
  1735.             E    0    0    0    1    1    1    0    1,2,3 - ON
  1736.             F    0    0    0    1    1    1    1    0,1,2,3 - ON
  1737.        --------------------------------------------------------------
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.        MSYS 1.18                                                   Page 20
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.        When you have more than 4 ports, a 2 digit hexadecimal value is
  1766.        required.  The following table represents the left-hand digit for
  1767.        ports 4,5, and 6.
  1768.  
  1769.        MASK VALUE  PORT NUMBER  CONDITION
  1770.  
  1771.                  6    5    4    1=ON, 0=OFF
  1772.  
  1773.             0    0    0    0    4,5,6 OFF
  1774.             1    0    0    1    4 - ON
  1775.             2    0    1    0    5 - ON
  1776.             3    0    1    1    4,5 - ON
  1777.             4    1    0    0    6 - ON
  1778.             5    1    0    1    4,6 - ON
  1779.             6    1    1    0    5,6 - ON
  1780.             7    1    1    1    4,5,6 - ON
  1781.  
  1782.        For ALL ports to be turned on, the MASK value would be 7F, and is
  1783.        written as $7F.
  1784.        For Ports 0 and 1 on, the MASK value would be 3, written as $3.
  1785.        For Ports 2 and 4 on, the MASK value would be 14, written as $14.
  1786.        For Ports 3 and 5 on, the MASK value would be 28, written as $28.
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.        MSYS 1.18                                                   Page 21
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.                                     DRSI CARDS
  1827.  
  1828.  
  1829.        Minimum things that must be done to use DRSI cards:
  1830.        Put HAPNDRSI.SYS in root (C:\) directory
  1831.        Put HAPNKISS.COM where it can be found to be executed.
  1832.        Put DEVICE=HAPNDRSI.SYS IRQ=7 (or whatever interrupt you have the
  1833.        board set up for) in CONFIG.SYS.
  1834.        Reboot system.
  1835.        Put:
  1836.          PORT 1 AT $0 INT 7 SPEED 1200 NAME *DRSI-0
  1837.          PORT 2 AT $1 INT 7 SPEED 1200 NAME *DRSI-1
  1838.        in MSYS.OPT and run MUTIL function 9.
  1839.        Notes: Change the port numbers to what is appropriate to your system
  1840.        .  The ports on the
  1841.        DRSI card are referenced by the numbers after the AT $ .  The INT 7
  1842.        is taken as comments only (but INT something is required).
  1843.        SPEED  of the DRSI ports is really set on the DEVICE=HAPNDRSI.SYS
  1844.        statement in CONFIG.SYS .  SPEED value given on port statement is
  1845.        more or less only comments.
  1846.        NAME must begin with *, can be something like *145.01 if you prefer .
  1847.  
  1848.        Before you start MSYS, you must run HAPNKISS.
  1849.  
  1850.        That should get you started.  For other configurations and options,
  1851.        read the appropriate documentation.
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.        MSYS 1.18                                                   Page 22
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.                                MSYS COMMAND SUMMARY
  1887.  
  1888.  
  1889.        The following is a SUMMARY of the commands available at the LOCAL
  1890.        keyboard for MSYS.  The commands may be abbreviated to the capital
  1891.        letters.  This list does NOT include the BBS commands that are
  1892.        available only from the BBS.  Most "LOCAL" commands may be executed
  1893.        from the BBS by prefixing them with a "/".  Please refer to the MSYS
  1894.        SYSOP section for more detailed explanation of the commands.
  1895.  
  1896.        *comment  Enables comment line from user to SYSOP
  1897.        #msgs/use Displays total number of active msgs and known user on BBS
  1898.        @home     Designates @ home bbs option
  1899.        ABortfwd  Aborts forwarding as soon as possible
  1900.        ADDUser   Allows sysop to add a user to bbs
  1901.        APpend    Used to append a file to a message and other general uses
  1902.        ARChive   Puts given @BBS in specified sub directory
  1903.        ARP       Lists the known callsign/IP address
  1904.        ARP add   Adds digipeaters to TCP/IP stations
  1905.        ARP del   Removes TCP/IP stations from arp list
  1906.        ATtended  Turn HF forwarding on and off
  1907.        AUTODest  Add new DESts for known neighbors
  1908.        AUTOHold  Hold messages that contain own call in R: lines
  1909.        AUTOKill  Kill all messages after forwarding
  1910.        AUTONode  Add new neighbors heard
  1911.        AX25Backoff    Provides exponential delay to RNR messages.
  1912.        AX25L2V2  Turns on Version 2 of the AX.25 protocol BY PORT #
  1913.  
  1914.        BADuser   Enables the bad user list
  1915.        BBs       Enter the BBS as a local user
  1916.        BBSNode   If on and the node is enabled, the bbs will appear as a
  1917.                  node to the network
  1918.        BBSTimeout     Number of seconds of inactivity on bbs to disconnect
  1919.                  user
  1920.        BDigi     Specifies digipeaters for beacons
  1921.        BElloff   Turns bells on or off.
  1922.        BID       Manipulates bids in the BIDLIST.DAT file.
  1923.        BINterval Nodes Broadcast interval
  1924.        BMaxcon   Maximum BBS connects
  1925.        BOOT      Reboots computer. (Remote sysop only)
  1926.        BPorts    Used to indicate BBS ports only
  1927.        BText     Specifies one line of beacon text
  1928.        BUDCalls  Set or display the list of calls with SSID to be monitored
  1929.        BUDList   For selective monitoring of BUDCalls
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.        MSYS 1.18                                                   Page 23
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.        C#        Attempt to connect to station via digi list given on port #
  1949.        CHAnstat  Displays status of a logical channel whose number is given
  1950.        CHEck     Number of 1 second intervals of no activity to disconnect
  1951.        CL B #    Change border color
  1952.        CLrscrn   Clear window number given or * for clear all windows
  1953.        CMdwindow Specifies the window # to be used for commands (CM 4)
  1954.        COPy sourcepathname destpathname   (include drive: if needed)
  1955.        CONference Used to enable/disable conference function in BBS
  1956.        CTS       Allows specification for each port if hardware hand shaking
  1957.                  should be used
  1958.        CRetries  Sets number of retries for forward connect attempt
  1959.        Cscript   Another form of the Connect command:
  1960.  
  1961.        DEADletter     Used as default for unknown @BBS
  1962.        DEBug          Used to display or modify memory
  1963.        DELEfile       Specifies file name to delete
  1964.        DELUDays       Specifies the number of days after which a user that
  1965.                       has not connected will automatically be deleted from
  1966.                       the system.
  1967.        DELUSer        Deletes a user from the user list
  1968.        DESt ADD, REP, DEL   Adds replaces or deletes destinations in
  1969.                       nodelist.
  1970.        DFree          Displays amount of disk space free
  1971.        DIGipeats      Displays digipeater/gateway list
  1972.        DIRectory      Displays directory for path specified Example:
  1973.                       DIR mail\*.*
  1974.        DISconnec      Forces a disconnect on logical channel specified
  1975.        DOcmdfile      To execute a command file
  1976.        DPorts         Allows sysop to selectively disable digipeater
  1977.        DRoute         Callsign port# [digi1...digi8]
  1978.        DTimedate      Displays current date and time
  1979.        DUmpbbs        Disconnect any bbs that has connected and uses a
  1980.                       command other than S or F.
  1981.        DUPcheck       Checks R: lines for BID checks & title/from call check
  1982.  
  1983.  
  1984.        EDit      Screen editor for files
  1985.        EFile     Edits the specified file
  1986.        EMsghdr   Edits the header of the specified message number in BBS
  1987.        EUser     Edits specified user
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.        MSYS 1.18                                                   Page 24
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.        F2 time   Number of seconds to continue displaying monitored packets
  2010.                  after F2 (function key) was last pressed.
  2011.        FBBC      Sets the FBB Compatibility mode
  2012.        FBBG      Sets the FBB forwarding group size
  2013.        FBBStimes Allows specification of hours bbs is full function
  2014.        FCall     Finds the logical channel(s) in use by given callsign
  2015.        FFile     (find file) FF *.DAT C:\
  2016.        FIle      Converts specified message number into file name given.
  2017.        FMsg      Searches messages in MAIL.BAK for given pattern string.
  2018.        FOrward   Initiates forwarding immediately
  2019.        FPactor   Initiates PACTOR or GTOR forwarding
  2020.        FRAck     Displays or sets time in seconds to retransmit a packet
  2021.        FREE      Deallocates the logical channel specified
  2022.        FSize     Displays the file size for the pathname specified
  2023.        FTIme     Forward time
  2024.        FTPgm     File Transfer Protocol
  2025.        FUlldup   Used on the specified ports if set to ON.
  2026.  
  2027.        GEtmsgotd Reads and displays Message of the day file
  2028.        GMtime    Sets GMT offset hours from local time for BBS use
  2029.        GRep      Will search the given file for the specified pattern
  2030.  
  2031.        HApnstat  Displays HAPN/DRSI statistics.
  2032.        HCAll     Allows you to properly specify your bbs hierarchical
  2033.                  callsign.
  2034.        HCLean    This command automatically deletes specified messages.
  2035.        HEard     The J heard list recording is turned off if # > Dispatches
  2036.        Help      Lists the names of the commands
  2037.        HOLdlevel Parameter is a number which if the sum of word weights
  2038.                  matched in message exceeds the value the message is held.
  2039.        HOStname  Hosts id name TCP/IP
  2040.        HReplace  Selects adding to end of existing hierarchical @BBS field
  2041.                  or replace.
  2042.  
  2043.        ID *      Forces transmission of an ID immediately (also mail for
  2044.        list)
  2045.        IGnore    Calls in budcalls list will not be monitored
  2046.        IMport    Imports messages from given filename.
  2047.        INitpr    Allows you to specify if printer should be initialized
  2048.                  before each file is printed.
  2049.        IPNCheck  Inactivity timeout in seconds.
  2050.        IPNFrack  Retry timer in seconds.
  2051.        IPNRetry  Retries, default 5.
  2052.        IPTtl     TCP/IP Time to live
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.        MSYS 1.18                                                   Page 25
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.        JBbs      Lists (P)BBSs heard and their paths
  2071.        JDigipeat Lists Digipeaters heard and their paths
  2072.        JGateways Lists Gateways heard and their paths
  2073.        JHeard    Lists stations heard and those connected to BBS
  2074.        JKanodes  Lists KA Nodes heard and their paths
  2075.        JMsys     List other MSYS systems heard
  2076.        JNetrom   Lists NET/ROM nodes heard and their paths
  2077.        JTcp/ip   Lists TCP/IP stations and their addresses
  2078.  
  2079.        KEyboard  Assign keyboard to channel number specified
  2080.        KILLproc  Abort specified process number (Can be hazardous!)
  2081.        KPorts    Allows sysop to selectively disable k NODe
  2082.  
  2083.        LCount    Counts number of lines, characters, and words in file.
  2084.        LOCKkbd   Locks the keyboard.  OR unLOCKs keyboard if locked.
  2085.        LOGclose  This command closes the log file, renames it to form of
  2086.                  yymmdd.LOG and then opens a new log file.
  2087.        LUsers    List known user calls that have connected to BBS
  2088.        LU xxx    Selects: BADusers, BBSystems, EXPert, LIMited, NEW, LOCked,
  2089.                  RESet, XFAst_set
  2090.  
  2091.                  NOTE: Use only the first 3 letters of the item from the
  2092.                  list for xxx!
  2093.        LZhuf     Enables Huffman coding on PACTOR connects.
  2094.  
  2095.        MAIlnew        Advises user of new mail.
  2096.        MAKEPrivate    Sets/resets making messages private by default
  2097.        MAStersrv      Specifies the master White Pages server (default is
  2098.                       N6IYA.#NOCAL.CA.USA.NOAM)
  2099.        MAXBullage     Used to discard bulletins older than a specified
  2100.                       amount
  2101.        MAXFOrward     Maximum # bytes to forward on specific port
  2102.        MAxFrames      Display or change number of frames sent before ACK
  2103.                       rcvd
  2104.        MAXRead        Specifies maximum size message that can be read or
  2105.                       file that can be downloaded
  2106.        MCForward      Ports where forwarding is counted as bbs connects.
  2107.        MCOn           Number of connects allowed to sysop keyboard
  2108.        MDir           Creates given directory
  2109.        MEMory         Display amount of memory free
  2110.        MERge          Reads MSYSFWD.DEF and copies it to MSYS.FWD
  2111.        MEXpert        If on, display the message of the day
  2112.        MHclear        Clears various J heard lists
  2113.        MIDchar        Message ID indicator (max 4 chars)
  2114.        MINmem         Allows specification of the minimum free memory
  2115.        MISsing        Reports number of times forwarding aborted due to
  2116.                       missing text file
  2117.        MONBframe      Enable/disable monitoring of Beacon (UI) frames
  2118.        MONCC          Enables/disables monitoring of TCP/IP packets
  2119.        MONCF          Enables/disables monitoring of NetRom packets
  2120.        MONIFrame      Enable/disable monitoring of Information frames
  2121.        MONITor        Enable/disable monitoring of incoming frames
  2122.  
  2123.  
  2124.        MSYS 1.18                                                   Page 26
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.        MONOutgoing    Enable/disable display of outgoing frames
  2131.        MONPorts       Select which ports to monitor [MASK]
  2132.        MONSFrame      Enable/disable monitoring of Supervisory frames
  2133.        MONUFrame      Enable/disable monitoring of Un-numbered frames
  2134.        MONxx          Enable/disable monitoring of PIDs on screen F2
  2135.                       monitoring
  2136.        MSgtrailer     Enable/disable message trailer on messages read from
  2137.                       bbs.
  2138.        MYAlias        Display or change bbs alias callsign
  2139.        MYBbs          Display or change bbs primary callsign
  2140.        MYCall         Display or change Call/Answer callsign
  2141.        MYIpaddr       Sets IP address that the system will respond to.
  2142.        MYKnode        Display or change K NODe callsign
  2143.        MYTcpcall      Callsign used when sending arp and TCP/IP frames
  2144.  
  2145.        NBdcast        Enables Node Broadcasts on a per port basis
  2146.        NDwindow #     Net default window size (#=frames 1-7)
  2147.        NETBbs         Enable BBS cmd in net NODe
  2148.        NETCon         Enable connect cmd in net NODe
  2149.        NETFbbstime    Allows specification of hours NET is full function
  2150.        NETFBBC #      NET/ROM FBB Compatibility
  2151.                       0=No FBB Compatibility (Default)
  2152.                       1=FBB Non-Compressed Compatibility
  2153.                       2=FBB Compression Compatibility
  2154.        NETFBBG        NetRom FBB forwarding group size (0-5)
  2155.        NETMaxfwd      Maximum message size to forward through network
  2156.        NETNode        Enable the Net Node
  2157.        NETOnly        If on, only BBSs can connect to bbs via network
  2158.        NETRead        Specifies maximum size message that can be read or
  2159.                       file that can be downloaded through the Netnode
  2160.        NETTalk        Enable Talk cmd in net NODe
  2161.        NETXBatchsize  Sets Max batch size for RLI compression on network
  2162.        NETXOption     If on, enables RLI compressed forwarding on network
  2163.        NETYapp        If on, allows YAPP transfers via network
  2164.        NEWUser #      Allows you to set the initial user flags
  2165.        NInfo          Gives net NODe status
  2166.        NNode          Takes you into the NODe as if you were connected to it
  2167.        NOBEacons      If a given port is set to 1 then there will be no ID,
  2168.                       mail for, or BText beacons
  2169.        NOBUlls        When on, no bulletins will be forwarded during normal
  2170.                       forwarding.
  2171.        NODe SEnd, SAve, REStore, ADD, REP, DEL
  2172.        NODETimeout #     Number of seconds of inactivity on network node
  2173.        NPorts            Ports to which nodes broadcast
  2174.        NRCall callsign   Sets net NODe callsign
  2175.        NRId mnemonic     Sets net NODe mnemonic identifier
  2176.        NTtl              Network time to live (max hops)
  2177.  
  2178.        OCInit            Initial obsolescence count
  2179.        OCMin             Minimum obsolescence to broadcast
  2180.        OKfrom            Specifies which non-callsigns in from field.
  2181.  
  2182.  
  2183.  
  2184.  
  2185.        MSYS 1.18                                                   Page 27
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.        PAClen    Specifies maximum number of bytes that are put in a packet
  2192.        PATh      Display information about given user callsign
  2193.        PC        Enables/disables callsign serverPForward Display
  2194.                  information about given BBS callsign
  2195.        PForward  Shows the forwarding path for messages @bbs
  2196.        PIng      Determines Round Trip Time to destination
  2197.        PMessage  Prints specified message
  2198.        POrts     Display information about ports
  2199.        PPersist  "Agressiveness" value (255 to 0)
  2200.        PQuality  Quality for nodes heard on port
  2201.        PRInt     Prints a file (on printer)
  2202.        PROcesses Display status of processes
  2203.        PRTmsgs   Enables/disables printing of messages
  2204.        PScan     Enables Pactor Scan
  2205.        PWindow   Sets window to be used by a process
  2206.  
  2207.        Qmsg      Copies msg into editor for reply.
  2208.        QUIT      Terminates execution of MSYS gracefully (more or less)
  2209.                  Also done with Ctrl F4
  2210.  
  2211.        RBid      Adds received BID/MID to R: Line
  2212.        RDir      Removes the given directory
  2213.        REadbackup     Allows you to read a message from the /MAIL.BAK
  2214.                  directory
  2215.        REMove DESt callsign     Deletes DESt through all neighbors
  2216.        REName    Oldpathname newpathname (must both be on same drive)
  2217.        REPlaces  Replaces incoming @BBS calls
  2218.        RESPonstime    Number of seconds to wait before sending out a
  2219.                  response
  2220.        RESTore   Restores a message from the mail.bak directory
  2221.        RETries   Displays or sets number of retries before disconnecting
  2222.        REQDIR    Enables/Disables Request directory server
  2223.        REQFIL    Enables/Disables Request File server
  2224.        REQMaxfile     Used to set a limit on the size of files that may be
  2225.                  requested from the REQFIL server
  2226.        REQQTH    Enables/Disables Request QTH server
  2227.        RLinetime Adjusts the R: line time for proper GMT offset.
  2228.        RUn       Allows you a DOS program with many limitations
  2229.  
  2230.        SCreensave     Enables/Disables screen saver
  2231.        SEnd      Sends a line of text to specified channel: SE 1 <text>
  2232.        SE-       Same as above with no "Message from Sysop": SE- 1 <text>
  2233.        SHUtdown  If on, advises users of impending bbs shutdown
  2234.        SLottime  Value (0 to 255)
  2235.        SMTP      Simple Mail Transfer Protocol
  2236.        SNow      Enables/disables changing screen only during retrace
  2237.        SOrt      Will sort up to 200 eighty byte records
  2238.        STatus    Displays some status information
  2239.        SUspendtrace   Number of free bytes in input buffers below which
  2240.                       monitoring is turned off
  2241.        SYsop     If on, adds to SYSOP messages to You have...message count.
  2242.  
  2243.  
  2244.  
  2245.  
  2246.        MSYS 1.18                                                   Page 28
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.        TABs      Enables/Disables tabs in the bbs
  2254.        TACk      Transport ACK delay (RESPonsetime)
  2255.        TBdelay   Transport busy delay
  2256.        TElnet    Used to establish keyboard to keyboard connection
  2257.        TERminal  A command which permits direct keyboard access to port
  2258.        TFrames   Send test frames
  2259.        TImezone  Allows entry of your time zone
  2260.        TNatime   Transport no activity timeout time
  2261.        TOdo      Causes the MSYSTODO.DAT file to be scanned immediately
  2262.        TPorts    Enables/disables ports for TCP/IP
  2263.        Trace25   Enables/disables trace of AX.25 state changes
  2264.        TraceIP   Enables/disables trace of TCP/IP state changes
  2265.        TREtries  Transport retries
  2266.        TRUncate  filename Adds CR/LF to files as needed
  2267.        TS (hhmmss)    TimeSet command - sets DOS time to given value (must
  2268.                  be exactly 6 digits)
  2269.        TTimeout  Transport timeout (Net FRACK)
  2270.        TXDelay   Transmit Delay time value (0 to 255)
  2271.        TXTail    Transmit Tail value (0 to 255)
  2272.        TYpe      Allows you to type a file
  2273.  
  2274.        Users <file_name> Writes out all users to file <file_name>
  2275.  
  2276.        VAlidmsgtype   Permits control over second character in message type
  2277.        VErifysysop Enables/Disables Sysop verification when connected to BBS
  2278.        VIdeo     Displays or changes video monitor in use
  2279.  
  2280.        WAtch     Toggles watching of specified channel number
  2281.        WBackgrnd Sets background color for specified window
  2282.        WColors   Gives list of colors and their numbers
  2283.        WForegrnd Sets foreground color for specified window
  2284.        WHO       Displays current users/messages
  2285.        WHY       Displays why message was held
  2286.        Window    Displays current window definitions
  2287.        WPAge     Sets page number to display specified window
  2288.        WPEvery   Specifies the number of days between sending out WP
  2289.                  information
  2290.        WQupdate  Worst quality DESt route to record
  2291.        WRecord   Window record which sends all output from specified window
  2292.                  to a disk file.  Useful for debugging
  2293.        WSize     Specifies coordinates for specified window
  2294.        W?        Displays window number in upper left of each window
  2295.  
  2296.        XBatchsize     Sets max batch size in bytes for RLI compression
  2297.        XOption   If on, enables RLI compressed forwarding on port
  2298.  
  2299.        Yapp      If on, enables YAPP transfers on port
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.        MSYS 1.18                                                   Page 29
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.        <Esc>     Cancel partially typed command
  2315.  
  2316.        Function key usage:
  2317.  
  2318.        F1 through F4   Select page to display (0 to 3 respectively)
  2319.  
  2320.        F6        Causes the following characters to the next return to be
  2321.                  treated as a command even if keyboard currently connected
  2322.                  to some other process (such as local bbs, etc.).
  2323.  
  2324.        F8 key    Used to blank the screen.
  2325.  
  2326.        Alt-F1 Alt-F2 Alt-F3 keys work like DOS F1 F2 and F3 commands to
  2327.                  retrieve/edit last sysop command typed.
  2328.  
  2329.        Ctrl/F2   Suspends activity on the monitor screen (F2).
  2330.        Ctrl/F4   Terminates MSYS as if QUIT command was used
  2331.        Ctrl/F5   Same as the PRocess command
  2332.        Ctrl/F6   Assigns keyboard to command processor
  2333.  
  2334.                  MOST COMMANDS GIVE INFORMATION ON THEIR USAGE IF
  2335.                  YOU TYPE THE COMMAND NAME FOLLOWED BY A QUESTION
  2336.                  MARK.
  2337.  
  2338.                  Example: WS ?
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.        MSYS 1.18                                                   Page 30
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.                                 MSYS SYSOP Commands
  2376.  
  2377.  
  2378.  
  2379.        *comment
  2380.             Not really a command as such, * may be used at the beginning of
  2381.             a line making anything else you type on the line a comment.
  2382.             Useful in MSYS.DO to temporarily remove commands.
  2383.  
  2384.        #msgs/use
  2385.             Displays total number of active msgs and known users on BBS .
  2386.             The number of messages that can be on the bbs is set by the
  2387.             Mutil Function 1 program.  The maximum number of users is 500.
  2388.  
  2389.        @home (ON/off)
  2390.             If On, causes @bbs field of messages for registered users of the
  2391.             system to be replaced with the home BBS they gave with the NH
  2392.             command (the way it has been done in the past) . If Off, the
  2393.             @BBS field is not modified.
  2394.  
  2395.        ABortfwd
  2396.             Aborts forwarding as soon as possible (not always immediately).
  2397.             You may want to DISC the channel forwarding is using
  2398.             (particularly if its trying to connect) to speed things up.
  2399.  
  2400.        ADDUser callsign
  2401.             Adds a user callsign to the user file without that station
  2402.             having to connect to the BBS . This can be useful in conjunction
  2403.             with the automatic @BBS generation . After the new user has been
  2404.             added you automatically will EUsers for the callsign at which
  2405.             time you can fill in the desired fields.
  2406.  
  2407.        APpend Sourcefile Destfile
  2408.             This command causes the source file to be appended to the
  2409.             destination file.  This command may be used to append a file to
  2410.             a message file, among other more general uses.
  2411.  
  2412.        ARChive @BBS filename
  2413.             This command will concatenate all current msgs with @BBS given
  2414.             to FILES/filename . No compression is done . Example: ARC RLIBBS
  2415.             RLINOTES/MSGS   (This assumes you have a RLINOTES subdirectory
  2416.             in the FILES directory)
  2417.  
  2418.        ARP
  2419.             Lists known callsign/IP address correspondence used for TCP/IP
  2420.             connects.  ARP stands for Address Resolution Protocol.
  2421.  
  2422.        ARP CLEAR
  2423.             Erase all of the ARP entries.
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.        MSYS 1.18                                                   Page 31
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.        ARP ADD callsign port# ip-address[/#] [digi1 [digi2 ...[digi8]]]
  2436.             Allows you to manually add (or put it in MSYS.DO) a station (and
  2437.             up to eight digipeaters) to the ARP list.  Periods are optional
  2438.             in the IP address.
  2439.  
  2440.             Examples:
  2441.             arp add WA8BXN 0 44 70 4 8 NO8M
  2442.             arp add N8HSP 2 44.70.4.10 WB8CQR-5 WB8APD
  2443.  
  2444.             You can put a / and a number after the IP address . For example,
  2445.             you can say:
  2446.             arp add W3AAA 1 44 80 1 1/24 K8AAA
  2447.  
  2448.             This says that any IP frames going to an IP address with 44 80 1
  2449.             in the left 24 bits should go to W3AAA (through K8AAA as a
  2450.             digi).
  2451.             Thus the number after the / is the number of significant bits to
  2452.             keep in comparisons.
  2453.  
  2454.        ARP DELete callsign
  2455.             Removes a single entry from the ARP table.
  2456.             Example: ARP DEL K8EIW
  2457.  
  2458.        ARP REP callsign port# ip-addr[/#] [digi1 [digi2 ... [digi8]]]
  2459.             Replaces existing arp entry for given callsign with new
  2460.             information specified.
  2461.  
  2462.        ATtended [ON/off]
  2463.             When set to ON all forwarding is allowed.  If off, ports with
  2464.             radio speed of 300 will forward only those messages in which the
  2465.             from call is the idcall (messages that you originate) or the to
  2466.             station in the message is the station you would directly connect
  2467.             to for forwarding.  HF reverse forwarding is also inhibited if
  2468.             ATtended is OFF.  Note that the regulations appear to allow you
  2469.             to receive messages unattended .  So if you don't have a STA for
  2470.             HF turn AT OFF when you aren't there and remember to turn it ON
  2471.             when you are.  To be on the safe side, put ATtended OFF in your
  2472.             MSYS.DO file should the system reboot when you aren't present.
  2473.  
  2474.        AUTODESt (on/OFF)
  2475.             When on and network node is enabled allows automatic updating of
  2476.             network node destination tables when node broadcasts are heard
  2477.             from neighbor nodes.
  2478.  
  2479.        AUTOHold (ON/off)
  2480.             This command specifies what should be done with messages that
  2481.             contain in them R: lines with your Hierarchical BBS callsign
  2482.             (see HCA command).  This normally indicates that the message has
  2483.             passed through your system before and probably is in a routing
  2484.             loop.  Currently such messages are held .  AUTO- Hold ON means
  2485.             to do this.  If AUTOHold is OFF the messages will not be held.
  2486.  
  2487.  
  2488.  
  2489.  
  2490.        MSYS 1.18                                                   Page 32
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.        AUTOKill [on/OFF]
  2497.             When on, non-bulletin messages are automatically killed after
  2498.             they have been forwarded.
  2499.  
  2500.        AUTONode [on/OFF]
  2501.             If on and network node is enabled, node broadcasts heard from
  2502.             new neighbor nodes are automatically added to the list of
  2503.             neighbor nodes.
  2504.  
  2505.        AX25Backoff [MASK]
  2506.             A 1 bit in a given port position in the mask causes the FRACK
  2507.             value for the port to be multiplied by the retry number to
  2508.             determine how long to wait before retransmitting packets that
  2509.             haven't been acked.
  2510.  
  2511.        AX25L2v2 [port#] [on/OFF]
  2512.             AX.25 version 2 protocol: Version 2 can be enabled for all ports
  2513.             or specified ports.  Version 1, the default, may be better for
  2514.             HF operation.
  2515.  
  2516.        BADuser [on/OFF]
  2517.             When ON, the calls in the BUDCall list will be totally ignored
  2518.             by the system.  Such stations will not be able  to connect to
  2519.             the system in any way (AX.25 or TCP/IP) and will not be
  2520.             digipeated.  Do NOT use SSIDs in  this list so that the listed
  2521.             calls can be used to match any incoming SSID the station may
  2522.             use.  Try to avoid using this facility unless really necessary
  2523.             as it does add some overhead in the processing of every packet
  2524.             received.  Hopefully stations that misbehave will realize that
  2525.             they can be turned off and not persist in their activity.
  2526.  
  2527.             The BADuser command is more inclusive than the Bad User Bit
  2528.             which can be set for a given user. Setting the bad user bit only
  2529.             prevents that user from using the BBS.  There is relatively
  2530.             little overhead in supporting the bad user bit since it is only
  2531.             checked when connects attempts to the BBS are made.
  2532.             Putting calls in the BUDCall list and turning on BADuser has a
  2533.             lot of overhead since every incoming packet has to be compared
  2534.             with each call in the BUDCall list.
  2535.  
  2536.        BBs [window#]
  2537.             Enter the BBS as a local user this command gets you into the BBS
  2538.             as if you had connected to the BBS, with a few minor
  2539.             differences.  Of course while you are using the BBS other
  2540.             stations can still connect as usual. When in the BBS you use the
  2541.             BBS command set (A,B,C,D,G,H,I,J,K,L,M,N,P,R,S,U,V,W,X,Y,?,*).
  2542.             If you use the L command you will see all messages including the
  2543.             private ones.  Likewise you can Read and Kill all private
  2544.             messages.
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.        MSYS 1.18                                                   Page 33
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.             You can include the contents of a file in a message you are
  2558.             sending by typing:
  2559.                  \+\ filename
  2560.             at the point you wish to include the file. If you want to
  2561.             include the contents of a message file from the MAIL.BAK
  2562.             directory, type:
  2563.                  \+\#msgnumber
  2564.                  at the point you want to include the file. Example:
  2565.                  \+\#1538
  2566.  
  2567.             You can specify a window number as an argument to the BB
  2568.             command.  BB 0 will use the top half of the F1 screen for
  2569.             example.  If you were in the BBS locally and leave it for some
  2570.             reason with it still active and use the BB command you will
  2571.             return to your previous session rather than starting a new one.
  2572.  
  2573.        BBSNode [ON/off]
  2574.             If on and the node is enabled, the BBS will appear as a node to
  2575.             the network (using the alias as the identifier and the BBS call
  2576.             as the call).  This way connects may be made to the BBS directly
  2577.             from the network.
  2578.  
  2579.        BBSTimeout #
  2580.             Number of seconds of inactivity on BBS to disconnect user,
  2581.             default 300 seconds.  Note that when version 2 of the AX.25
  2582.             protocol is enabled, no activity for CHEck time does not causes
  2583.             a disconnect.
  2584.  
  2585.        BDigi [digi1 [digi2 ... [digi8]]]
  2586.             Lets you specify up to 8 digipeaters for beacons (id, mail,
  2587.             btext). The list of digipeaters can be different for each port.
  2588.             If only a port number is given, the digipeater list for that
  2589.             port is cleared.
  2590.             Examples:
  2591.                  bd 4 digi1 digi2  sets digi1 and digi2 as digipeaters for 
  2592.                  port 4 only
  2593.                  bd digia digib    sets digia and digib for all ports
  2594.                  bd 5              clears digipeaters for port 5
  2595.  
  2596.        BElloff (ON/off)
  2597.                  On   All bells are turned off.
  2598.                  OFF  All bells are sounded.
  2599.                  -1   Keyboard connects sound but not other connects.
  2600.  
  2601.        BID
  2602.             Manipulates bids in the BIDLIST.DAT file.  The following
  2603.             operands may be specified:
  2604.                  + bidstring    Adds given bidstring to bid file
  2605.                  - bidstring    Deletes given bidstring
  2606.                  = bidstring    Tells if given bidstring is present
  2607.                  #                   Tells number of active bids/mids
  2608.  
  2609.  
  2610.  
  2611.  
  2612.        MSYS 1.18                                                   Page 34
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.        BINterval number
  2619.             Network node broadcast of known destination nodes is made every
  2620.             number seconds.
  2621.  
  2622.        BMaxcon [port#] #
  2623.             This command limits the maximum number of connects to the BBS on
  2624.             each port.  BBS connects are exempted from the limit but count
  2625.             for other users.  Normal users get a BUSY response when over
  2626.             limit.  BM 1 allows 1 user  per port. If a port is marked BBS
  2627.             ONLY (see BPorts) the BMax value  specified limits the number of
  2628.             BBS connects.  For non-BBS only ports, the BMax value does not
  2629.             effect number of BBS connects. See also the MCF command.
  2630.  
  2631.  
  2632.        BOOT
  2633.             Boots computer. You should have an autoexec.bat file set up that
  2634.             runs MUTIL 4 and then MSYS so that after you reboot the computer
  2635.             MSYS will be restarted. Note that this is an abrupt termination
  2636.             of MSYS. Files are not closed for example.  The correct reply to
  2637.             the question asked by the boot command is Yes (CASE IS
  2638.             IMPORTANT).
  2639.  
  2640.        BPorts [MASK]
  2641.             This command is used to indicate which ports are BBS ONLY
  2642.             connects.  A One in the corresponding bit  position makes a port
  2643.             BBS ONLY.  For example, BP 5 would only allow BBS connects on
  2644.             ports 0 and 2.   The default is no BBS-only ports.  If you do
  2645.             use this command to make BBS only ports, you better be sure to
  2646.             mark all the BBS stations that you want to forward to you on
  2647.             BBS-only ports with user flag of 2!
  2648.  
  2649.        BText [port#] text
  2650.             Lets you specify 1 line of up to 80 characters of your own
  2651.             beacon text.  Can be different for each port. Use with great
  2652.             restraint!
  2653.  
  2654.        BUDCalls [callsign1 [callsign2 ... [callsign10]]]
  2655.             Set or display the list of calls with SSID to be monitored or
  2656.             ignored. This command is used in conjunction with the  BUDLIST
  2657.             or BADuser commands.  As operands you give a list of callsigns,
  2658.             with SSIDs, that are to be monitored or ignored.  The calls
  2659.             should be separated by blanks.  To list the current setting of
  2660.             BUDCalls, type the command with no operands.
  2661.             Examples:
  2662.             budc w1xx w2xx-1 w2xx
  2663.             budcalls K9XXX
  2664.             budc
  2665.  
  2666.             Note: there can be up to 10 calls.
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.        MSYS 1.18                                                   Page 35
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.        BUDList [on/OFF]
  2680.             To enable only those packets with calls in the BUDCalls list to
  2681.             be monitored use the command BUDL ON.   To monitor packets for
  2682.             all calls, use the command BUDL off.  OFF is the default
  2683.             setting.
  2684.  
  2685.  
  2686.        CHAnstat channel#
  2687.             Displays status of a logical channel whose number is given.
  2688.             This command requires an active channel  number as a parameter.
  2689.             Information about the channel will be displayed in response to
  2690.             this command.  The  information includes the Port number used,
  2691.             the call of the station connected to and a status byte in hex.
  2692.  
  2693.        CHEck [number]
  2694.             Number of 1 second intervals of no activity to disconnect if
  2695.             Version 1 of the AX.25 protocol is in use, or to send an RR Poll
  2696.             if Version 2 is enables (see AX25L command). To see what value
  2697.             is currently set, give the command with no parameters.
  2698.  
  2699.        CL B number
  2700.             Allows you to set the border color (used on all screens).  Use
  2701.             the WC command to see the color list.   Default color is black
  2702.             for the border.  Any of the 16 color numbers (0-15) may be used.
  2703.  
  2704.        CLrscrn [number/*]
  2705.             Clear window number given or use * to clear all windows. If no
  2706.             parameter is given, then the command processor window is
  2707.             cleared.
  2708.  
  2709.        CMdwindow number
  2710.             This command is used to change which window is used by the
  2711.             command processor.  The default command  window is number 0
  2712.             which by default is the upper half of display page 0.  This
  2713.             command is useful when you  want a larger window (to type a file
  2714.             for example) to be used by some command.  The new window is
  2715.             cleared  automatically by this command.  You will then get the
  2716.             cmd: prompt.  (page 0 =F1 page 1 = F2 etc.) A good windowk to
  2717.             use is 4 (CM 4) which is the one you see when you press F4.
  2718.  
  2719.        COPy
  2720.             Sourcepathname Destpathname (include drive: if needed) The copy
  2721.             command copies the specified files and will return an error
  2722.             message if it isn't able to copy all the records.  Directories
  2723.             and wildcards can be used.
  2724.  
  2725.        CRetries number
  2726.             Sets number of retries that there will be for forward connect
  2727.             attempt. This value should probably be less than RETries.
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.        MSYS 1.18                                                   Page 36
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.        C script-filename
  2741.             In addition to the usual C# form (like C0) there is now a
  2742.             connect command in which you do not specify a port number with
  2743.             the C, nor do you give the call of the station to which you want
  2744.             to connect, but rather give the name of a file that contains a
  2745.             connect script to reach that station.  The files must be in the
  2746.             /FWD directory and can have any name.  The connect script is the
  2747.             same format used in the forward file except that the first line
  2748.             begins with C rather the other letters used in the forward file.
  2749.             You can thus use the command C HOME in which case in the FWD
  2750.             directory you would have a file called HOME.  An example of the
  2751.             contents of this file is
  2752.             c0 wa8bxn
  2753.             @olvgn
  2754.             #120
  2755.             +to
  2756.             .c akron
  2757.             #180
  2758.             +to
  2759.             .c cle220
  2760.             #300
  2761.             +to
  2762.  
  2763.             This example can be interpreted as follows.  In the first line
  2764.             the C means this is a connect script, port 0 is to be used for
  2765.             the initial connect, and the ultimate destination is WA8BXN.
  2766.             The second line says to make a connect to OLVGN (which is a
  2767.             network node).  The following lines are commands sent to the
  2768.             node, the # lines are times to wait for responses, and the +to
  2769.             lines indicate the responses to look for that indicate success.
  2770.             See the descriptions for forwarding scripts for more information
  2771.             on these various options.  Another simple example of what you
  2772.             could put in a connect script file is
  2773.                  C0 WA8BXN
  2774.                  @WA8BXN V TOMSYS
  2775.             That's the entire file; it is a simple way to put the digipeater
  2776.             (TOMSYS) needed to reach the destination station (WA8BXN).
  2777.  
  2778.  
  2779.        CTS [port#] [on/OFF]
  2780.             Allows specification for each port if hardware handshaking
  2781.             should be used with the TNC or Modem.  If on, MSYS will suspend
  2782.             sending data to the TNC or Modem when Clear to Send is not true.
  2783.             This will be quite useful with AEA TNCs which have problems when
  2784.             MSYS sends packets too rapidly to them. Also useful with most
  2785.             Modems.  Make sure you have the proper wires in the cable
  2786.             between the computer and TNC or Modem, and that you have your
  2787.             TNC or Modem configured properly if you try to use this option.
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.        MSYS 1.18                                                   Page 37
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.        C# callsign [Via digi1 [digi2  ... [digi8]]]
  2802.             This command is used to connect to another station.  The letter
  2803.             C must be followed by a digit indicating the port number to be
  2804.             used for the connection.  This is followed by a space.  Next
  2805.             comes an optional window number to be used for the conversation.
  2806.             Next comes the callsign of the station you want to connect to,
  2807.             with SSID if needed.  Following this can come Via and a list of
  2808.             digipeaters to use, separated by commas.
  2809.                  Examples:
  2810.                  c1 w1xxx
  2811.                  c0 w2xxx v k2xxx
  2812.                  c2 k3xxx-2 v n4xxx-3,a5xxx
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.        MSYS 1.18                                                   Page 38
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.             When you issue this command the screen to be used for the
  2863.             conversation will be cleared and you will see a line "Enter
  2864.             converse for channel # port #".  When connection is made you
  2865.             will get a message "*** Connection established to callsign".  If
  2866.             the attempt retries out (determined by the RETries value), you
  2867.             will get the message "Quit converse for channel # because no
  2868.             connect!".  In this case the default CALL process window may
  2869.             show "*** callsign busy" if this is why the connection could not
  2870.             be made.  Pressing any key before getting one of these messages
  2871.             will abort the connect attempt and return you to the current
  2872.             command processor window.  When you are connected to a station,
  2873.             you type lines to be sent to the other station and will see
  2874.             lines typed by the other station.  Once you begin typing a line
  2875.             it will not be interrupted by lines from the other station until
  2876.             you press return.  To terminate the connection, type ^C, the
  2877.             letter d (^Cd) and press return.
  2878.  
  2879.             If you want to save what you are getting on disk, press the \
  2880.             key three times and then press return.  You will get the message
  2881.             "*** Capture file opened ***".  All lines you receive will be
  2882.             displayed as usual as well as being written to the file
  2883.             CAPTURE.DAT.  When you turn capture on with the \\\ at the
  2884.             beginning of a line, you can also specify a filename to be used
  2885.             in place of the default CAPTURE.DAT.  For example you can type
  2886.             \\\ junk.abc to start capturing your conversation into the file
  2887.             JUNK.ABC.  When you have already turned capture on during a
  2888.             connection, if you type something like \\\morejunk.xyz then the
  2889.             current capture file will be closed and now your conversation
  2890.             will be saved in the file MOREJUNK.XYZ.  Three \followed by
  2891.             return will alternately suspend and resume the capturing of
  2892.             lines to disk.  When you disconnect (or get disconnected) the
  2893.             capture file will be closed.  Note: That the default capture
  2894.             file name is always CAPTURE.DAT.  These files can be viewed by
  2895.             using the TYpe command or edited with the EFile command You
  2896.             could for example connect to some other BBS, read a message
  2897.             found there after turning on capture and then include the
  2898.             capture file in one of your own messages.  This procedure is
  2899.             explained in more detail for the BBs command above.
  2900.  
  2901.             You can also send any file on your system as if you typed it on
  2902.             your keyboard to the station you are connected to by typing
  2903.             \+\filename
  2904.             at the beginning of a line. Example:
  2905.             \+\ files\stuff
  2906.             would send the file called stuff from the files subdirectory.
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.        MSYS 1.18                                                   Page 39
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.        DEADletter (bbscall)
  2924.             This command specifies a BBS call that will be used for private
  2925.             messages entered on your system without @BBS and whose home bbs
  2926.             is not known.  This permits you to forward the messages to a WP
  2927.             server or another station that enjoys tracking down unknown
  2928.             souls.
  2929.  
  2930.        DEBug 
  2931.             This command is primarily used during development of MSYS.  Its
  2932.             results will change from release to release and are not further
  2933.             documented.  Although it should not do any damage it will
  2934.             probably be of little use to the normal Sysop.
  2935.  
  2936.        DELEfile pathname
  2937.             This command is used to delete a file.  You must give as a
  2938.             parameter a single file path name with or without wildcards.
  2939.             The parameter can contain a drive specification and/or directory
  2940.             names for the given file.
  2941.                  Example: DELE mail.bin\*.*
  2942.  
  2943.        DELUDays number
  2944.             Specifies the number of days after which a user that has not
  2945.             connected will automatically be deleted from the system.
  2946.             Default is 100 days.  Locked users (see bit list in EUser cmd),
  2947.             BBS call signs and bad users are not automatically deleted.
  2948.  
  2949.        DELUSer callsign
  2950.             This command removes a user call from the BBS user list.  The
  2951.             callsign given as a parameter must match the a call seen on the
  2952.             list produced by LUsers exactly (including case).  Use this
  2953.             command to REMove users that haven't been active lately when you
  2954.             are getting near the capacity of the list (currently 500 users).
  2955.             The last time a given station connected to the BBS may be
  2956.             obtained by using the P command while in the BBS.  If you give *
  2957.             for the callsign (as in DELUS *) then most user entries that
  2958.             contain garbage callsigns or ? for the user's name.  This option
  2959.             is pretty safe to use, but if in doubt make a copy of the
  2960.             MSYS.USR file if you wish.
  2961.  
  2962.        DESt ADD [id:]destcall neighborcall neighborport obs# quality
  2963.             Adds new network destination node which is routed through given
  2964.             neighborcall using specified port. The obsolescence count and
  2965.             quality values are stored as well.
  2966.  
  2967.        DESt REP [id:]destcall neighborcall neighborport obs# quality
  2968.             Changes obs# and quality for specified destination node
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.        MSYS 1.18                                                   Page 40
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.        DESt DEL [id:]destcall neighborcall neighborport
  2985.             Deletes route to specified destination node through given
  2986.             neighbor.  When all routes have been deleted, the destination
  2987.             itself is also removed from the network node tables.  See also
  2988.             the REMove command.
  2989.  
  2990.        DFree [driveletter:]
  2991.             Displays the number of bytes free on a disk. If no operands are
  2992.             given the space is for the default disk (normally C:).  If a
  2993.             letter is given as a parameter, the number of free bytes will be
  2994.             given for that drive.  Be sure the drive is ready before using
  2995.             this command. If its not and you get the DOS error message, type
  2996.             I for ignore.
  2997.  
  2998.        DIGipeaters 
  2999.             This command displays the list of digipeater definitions and
  3000.             related information. The output of this command is the same as
  3001.             using the ID command in the BBS.
  3002.  
  3003.        DIRectory [path]
  3004.             Displays directory for path specified Example DIR mail\*.* This
  3005.             command displays a sorted directory listing.  Only the names of
  3006.             the files (or directories) are given, not the sizes.  To get the
  3007.             size of a file, use the FSize command described below.  Names of
  3008.             directories are enclosed in <>.  If no argument is given, you
  3009.             will get a directory for the current default directory (normally
  3010.             C:\MSYS).  To list some other directory, give the path to that 
  3011.                  directory and a file name of *.*.  Other file
  3012.             specifications can be given for a selective directory list.  If
  3013.             you include a drive specification in the pathname, be sure the
  3014.             drive is ready before using this command.  Examples:
  3015.                       dir mail\*.*
  3016.                       dir a:*.*
  3017.                       dir files\*.c
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.        MSYS 1.18                                                   Page 41
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.        DISconnect channel#
  3046.             This command can be used to force a disconnect on the specified
  3047.             active channel. If the channel you specify was in the process of
  3048.             disconnecting when you use this command, then the channel will be
  3049.             immediately disconnected. Otherwise the channel will begin
  3050.             disconnecting when you use this command. Use it a second time for
  3051.             that channel if you want to speed up the disconnect.
  3052.  
  3053.             The disconnect command can be useful when you want to shut down the
  3054.             system. Another good use is force a disconnect from the bbs you are
  3055.             forwarding to after you have used the ABort command to abort
  3056.             forwarding.  The disconnect command also will properly terminate a
  3057.             modem or a pactor connection.
  3058.  
  3059.        DOcmdfile filename
  3060.             This command is used to execute the sysop commands found in the
  3061.             specified file.  A command file will contain the same things you
  3062.             would normally type as commands.  To execute a command file,
  3063.             type DO followed by the command file name. Example:  DO cmds.dat
  3064.  
  3065.        DPorts [MASK)
  3066.             A one in the mask for a given port permits digipeat on that
  3067.             port.
  3068.  
  3069.        DRoute callsign port# [digi1 ... digi8]
  3070.  
  3071.        DRoute DELete
  3072.             The first form of this command allows you to specify the TCP/IP
  3073.             station to which IP frames are routed by default (Default
  3074.             Route).  You specify as parameters the callsign of that station
  3075.             (with SSID) and the port number used to reach that station.
  3076.             Optionally up to 8 digipeaters can also be specified to be used
  3077.             to reach that station.   The second form of this command allows
  3078.             you to turn off default routing of IP frames.  If you do have a
  3079.             default route specified, then all incoming IP frames that are
  3080.             not otherwise handled by existing ARP table entries will be sent
  3081.             to the default station.  This station will also be used for any
  3082.             server functions you initiate (telnet for example) to IP
  3083.             addresses that are not currently in your ARP table.  Care must
  3084.             be taken in deciding if this command is appropriate to use in
  3085.             your particular situation.
  3086.  
  3087.        DTimedate
  3088.             This command displays what the computer thinks the current date
  3089.             and time is. The time can be changed with the TS command.  To
  3090.             change the date you must exit MSYS and use the DOS date command.
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.        MSYS 1.18                                                   Page 42
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.        DUmpbbs [ON/off]
  3107.             Disconnect any BBS that has connected and uses a command other
  3108.             than S or F.  A BBS is defined as a station that sends a SID
  3109.             ([...]) line.  This is useful in cases where the two BBB's get
  3110.             out of sync and message titles/text are being interpreted as
  3111.             commands.
  3112.  
  3113.        DUPcheck [arg]
  3114.             0 - Disables R: line BID checks & title/from call check
  3115.             1 - Holds messages that fails these checks.
  3116.  
  3117.        EDit filename
  3118.             Screen editor for files.  Escape gets to command mode, do help
  3119.             for command list. See section on EDITVIEW later in this document
  3120.             for more information.
  3121.  
  3122.        EFile filename
  3123.             This command is used to edit an ASCII file with re- cords <= 80
  3124.             bytes in length.  At least one operand is required which is the
  3125.             pathname to the file you want to edit.  A second operand may
  3126.             optionally be given that gives the size of the work area in
  3127.             lines to be allocated (default is 200).  See the separate
  3128.             documentation for EDITFILE for more information on the editor.
  3129.  
  3130.        EMsghdr msg#
  3131.             This command allows you to edit the fields of a message header.
  3132.             One operand is required which is the message number to edit.
  3133.             This command also automatically sets the message length to the
  3134.             actual size of the associated message file.  This is useful when
  3135.             you have replaced a message file with some other file as
  3136.             described above.  This command is also useful to change the
  3137.             status of messages to ALL (or others) that have not been marked
  3138.             as being read (but actually have been) so that they don't appear
  3139.             in the MAIL FOR list sent out with each ID.  If you press Esc
  3140.             when editing you will skip the current and remaining fields and
  3141.             see the header again.  This allows you to bypass having to press
  3142.             return for all the fields you don't want to change.
  3143.  
  3144.             If you place a string of characters that begins with a period
  3145.             after the message number, it will be appended to the existing
  3146.             @BBS field of the given message.  Thus if the @BBS of message
  3147.             123 was WA8BXN then:
  3148.             EM 123 .NTSOH
  3149.             would cause the @BBS field of message 123 to become
  3150.             WA8BXN.NTSOH.
  3151.  
  3152.             If you type a blank for the BID field the Bid is cleared
  3153.             entirely (you still need to get rid of the $ in the type).
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.        MSYS 1.18                                                   Page 43
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.        EUser callsign
  3168.             Edits user information. Also displays the meanings of the
  3169.             possible user flags bits. The EUser command will give a display
  3170.             similar to the following:
  3171.        cmd: eu k8eiw
  3172.        K8EIW is Don located at Cuyahoga Falls, OH  Last new message 36457
  3173.        Last connected Sun Nov 21 23:29:36 1994 on port -1 Flags=$1A53
  3174.        Lines=19
  3175.        Postal code:44223 Home BBS: WB8BII Last WP Update: Jul 15 01:00:03
  3176.        1990
  3177.        Path to K8EIW is <Local Console>
  3178.        User flags:
  3179.        $8000 New user
  3180.        $2000 No auto LC in bbs          $1000 Autoreply
  3181.         $800 YAPP upload authorized      $400 User password required
  3182.         $200 File upload authorized      $100 Lock user
  3183.          $80 Can't use S cmds             $40 Multiline packets (XF)
  3184.          $20 Need to send WP Update       $10 Remote sysop
  3185.          $08 Limited function BBS         $04 Bad user
  3186.          $02 BBS                          $01 Expert user
  3187.  
  3188.             The flags add hexidecimally per character position.  For
  3189.             example, if a user has both File upload and YAPP upload
  3190.             privileges, the flag for that position would be "A".
  3191.  
  3192.             To prevent WP messages from being issued on a particular call,
  3193.             such as V1SIT, set the flag to $100 at a minimum.
  3194.  
  3195.             The No Auto LC, Autoreply, Multiline Packets, and Expert User
  3196.             flags can be set by users with the appropriate XC, XR, XF, or X
  3197.             commands.
  3198.  
  3199.             In the above example, the flags 1A53 mean this user has
  3200.             Autoreply turned on, YAPP and File upload permitted, Multiline
  3201.             packets will be sent, is a remote sysop, and is a bbs and an
  3202.             expert user.
  3203.  
  3204.        F2time number
  3205.             The number of seconds to continue displaying monitored packets
  3206.             after F2 (function key) was last pressed.  The default is 600
  3207.             seconds (10 minutes).  Thus 10 minutes after you last press F2
  3208.             monitoring will be turned off until you press F2 again.  If you
  3209.             set F2 to 0 this function will be turned off. There is a fair
  3210.             amount of overhead in formatting all the information displayed
  3211.             on the F2 screen so on slower systems it is a good idea to allow
  3212.             the display to be suspended when you aren't actively looking at
  3213.             it!
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.        MSYS 1.18                                                   Page 44
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.        FBBCompat [port#] [0, 1 or 2]
  3229.             This command determines the level of compatibility with FBB
  3230.             style forwarding.  FBBC 0 means MSYS will forward non-compressed
  3231.             to all stations as before.  FBBC 1 means that MSYS detects the
  3232.             "F" in the SID, it will forward non-compressed, but in FBB style
  3233.             groups.  FBBC 2 Means that if a station identifies itself with a
  3234.             "B" and "F" in the SID, it will forward compressed in groups per
  3235.             the FBB style format.  It should NEVER be specified for the
  3236.             modem port due to the high probability of buffer overflows.
  3237.  
  3238.        FBBGroupsize #  [1-5]
  3239.             This command determines the maximum number of messages that may
  3240.             be forwarded out in one group using FBB compliant protocol.  The
  3241.             maximum group size is 5.  In FBB systems, the maximum group size
  3242.             is 10K bytes, and the number of messages proposed in the group
  3243.             for forwarding will be limited by this value.  MSYS does not
  3244.             have this limitation.
  3245.  
  3246.        FBBStimes [Port#] [time-range]
  3247.             Allows specification of hours BBS is full function for each
  3248.             port. Default is 0-23 which is all the time. The format of the
  3249.             time range is the same as used on the ! lines in the forwarding
  3250.             file.
  3251.  
  3252.        FCall callsign
  3253.             This command finds the channel associated with a callsign.  The
  3254.             single required operand is a callsign without SSID.  All
  3255.             channels in use by that callsign (with any SSID) will be
  3256.             displayed giving the Port, process number and name and complete
  3257.             callsign (with SSID).  This can be useful when you were in the
  3258.             middle of a conversation with some station (and still connected)
  3259.             but switched the keyboard to some other process (maybe the
  3260.             command processor) and now want to get back to that
  3261.             conversation.  Use the KEyboard command with the appropriate
  3262.             process number to do so.
  3263.  
  3264.        FFile filenamepattern [starting-path]
  3265.             When you give a file name pattern and optionally a starting path
  3266.             location this command will list all files that match the
  3267.             pattern.  The following would find all files that have the
  3268.             extension .DAT on your C: disk
  3269.             FF *.DAT C:/
  3270.             The output from this command gives the date, time, size and
  3271.             complete path names for all files that match the search
  3272.             specification.
  3273.  
  3274.        FIle msg# filename
  3275.             Converts specified message into a file with name given. This
  3276.             command removes the R: lines at the beginning of the file it
  3277.             creates.  If you really want to keep them, use an appropriate
  3278.             rename command instead.
  3279.  
  3280.  
  3281.  
  3282.  
  3283.        MSYS 1.18                                                   Page 45
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.        FMsg pattern-string
  3290.             Searches all messages in MAIL.BAK directory for given pattern
  3291.             string.  For example, to find messages that refer to hurricanes
  3292.             you might type:
  3293.             FM hurricane
  3294.  
  3295.        FOrward [callsign]
  3296.             This command causes forwarding to begin immediately if it is not
  3297.             currently going on.  You might want to use this command when you
  3298.             have just entered a new message with an @BBS specification that
  3299.             you want sent out now.  FO with a callsign of a single station
  3300.             begins forwarding to that station.  This must match the callsign
  3301.             (including SSID) found on the F/R/P line in the forward file.
  3302.  
  3303.        FRAck number
  3304.             This commands allows you to set or display the number of seconds
  3305.             to wait for an acknowledgment to arrive for a packet that is
  3306.             sent out.  If it doesn't arrive within the number of seconds
  3307.             specified the packet will be retransmitted.  The retry count for
  3308.             the channel will also be incremented.  Making this parameter to
  3309.             small will congest the channel and cause unwarranted
  3310.             disconnects.  The default is 6 seconds.  If in doubt, error on
  3311.             the high side! (port number optional)  All IP (and IP through
  3312.             netrom) frame retry timing uses a dynamic FRACK value.
  3313.  
  3314.  
  3315.        FREE chan#
  3316.             This command allows you to immediately release an allocated
  3317.             channel.  The process using the channel will see this as a
  3318.             disconnect.  This command will not be needed very often.
  3319.             Disconnecting which frees the channel will automatically occur
  3320.             after the CHEck interval has expired with no activity.
  3321.             Sometimes unpredictable results can occur with this command.  It
  3322.             is best to permit the DISC command do it's thing.
  3323.  
  3324.        FSize filename
  3325.             This command can be used to determine the size of a disk file.
  3326.             One operand is required which is the pathname to the file you
  3327.             want the size of.  It may include a drive specification and
  3328.             directory paths in addition to the file name.  Wild cards are
  3329.             not allowed.  Be sure the drive containing the file is ready
  3330.             before using this command.
  3331.  
  3332.        FTIme number
  3333.             This command sets the time in minutes after the hour that
  3334.             forwarding will start.  If time is negative number such as -5
  3335.             then you will forward every 5 minutes.
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.        MSYS 1.18                                                   Page 46
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.        FTPgm host-id
  3351.             Takes a host-id as an argument (it can be either an IP address
  3352.             in the square brackets or a symbolic IP address).  It
  3353.             establishes a connection to the FTP server of the specified
  3354.             system.  FTP is the File Transfer Protocol used in TCP/IP.
  3355.  
  3356.        FUllduplex [port#] [on/OFF]
  3357.             Enables full duplex operation in the TNC on selected ports. This
  3358.             may be useful for satellite operation or with full duplex
  3359.             repeaters.  Examples:
  3360.                  FU ON     turns full duplex on for all ports
  3361.                  FU 2 OFF  turns full duplex off for port 2
  3362.  
  3363.        GEtmsgotd
  3364.             This command causes the Message of the day file (MSYS.OTD) to be
  3365.             read and displayed.  The Message of the day is sent to all
  3366.             stations connecting to the BBS.  You can create and/or change
  3367.             this file using the EFile command.  Keep the contents short! See
  3368.             also MEXpert command.
  3369.  
  3370.        GMtime hours
  3371.             This sets the GMT offset from the local time.  The computer can
  3372.             be set for local time.  GMtime will then offset MSYS time to the
  3373.             proper GMT time.  If the TImezone GMT option is set, MSYS will
  3374.             insert the proper GMT in R: lines. Mutually exclusive with
  3375.             RLinetime.
  3376.  
  3377.        GRep filename search-string
  3378.             Will search the given file for the specified pattern, displaying
  3379.             lines that contain the given string. Case is ignored in the
  3380.             search. Wild cards are NOT allowed.
  3381.  
  3382.        HApnstat
  3383.             Provides HAPN/DRSI interface statistics.
  3384.  
  3385.        HCAll string
  3386.             This command allows you to properly specify your BBS
  3387.             hierarchical callsign.  This is the callsign put in the R: lines
  3388.             of messages as they pass through your system.  If you don't give
  3389.             this a value, your ID callsign will be used.  There is a maximum
  3390.             of 49 characters for this entry.  Hint: if you run more than one
  3391.             copy of MSYS for some reason and pass messages between the two
  3392.             systems, make your HCAll slightly different on each.  I might
  3393.             use for example WA8BXN.OH.USA on one and WA8BXN.OH.USA.NA on the
  3394.             other.  This will prevent unnecessary holding (or deleting, see
  3395.             OLdbids) of messages validly passed from one system to the
  3396.             other.
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.        MSYS 1.18                                                   Page 47
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.        HCLean [number]
  3412.             This command allows you to automatically delete specified
  3413.             messages every day at specified time (see MSYS.HCL in index). If
  3414.             no operand is given HCL shows time in minutes after 00:00
  3415.             (midnight) that housecleaning happens. If a number is given as
  3416.             an operand it sets the time for housecleaning in minutes after
  3417.             00:00 (midnight).
  3418.  
  3419.        HCLean NOW
  3420.             Manually initiates housecleaning.
  3421.  
  3422.  
  3423.        HEard number
  3424.             The J heard list recording is turned off if the number of
  3425.             dispatches per second in the last minute is less than the number
  3426.             given.  Default value is 3100 which j heard recording.  J Heard
  3427.             list recording takes quite a bit of computation for every packet
  3428.             heard.  This command was added to speed things up on slower
  3429.             computers.  (you might want to use a value of 10) Help  This
  3430.             command lists the names of the available commands with the
  3431.             required part of the command name in capital letters.
  3432.  
  3433.        HOLdlevel number
  3434.             Parameter is a number which if the sum of word weights matched
  3435.             in message exceeds the value, the message is held.  Default is
  3436.             0, which will hold if any words are matched.  See Automatic
  3437.             Message Holding
  3438.  
  3439.        HOStname string
  3440.             Sets TCP/IP hostname.  Maximum of 49 characters.
  3441.  
  3442.        HReplace [ON/off]
  3443.             This command selects adding to end of existing hierarchical @BBS
  3444.             field info from BBSTONTS.DAT file (if HRep is off) or replacing
  3445.             anything past the first part with the information from the
  3446.             BBSTONTS.DAT file (if HRep is ON).  Note that if some MSYS knows
  3447.             how to forward from some existing part of the @BBS field, no
  3448.             changes are made to it.
  3449.  
  3450.        ID [*]
  3451.             This command will send out an ID on all the ports immediately.
  3452.             You might use it to see if all your radios go into transmit as
  3453.             they should.  It also will send out the MAIL FOR list.  The text
  3454.             of the ID is not displayed at this time, but is shown once
  3455.             during initialization.  Nothing is displayed by the automatic
  3456.             IDs sent out (on the F1 screen).  To see what mail is
  3457.             outstanding for local users, type ID.  To really force an ID to
  3458.             be sent, type:
  3459.              ID *
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.        MSYS 1.18                                                   Page 48
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.        IGNORE [on/OFF]
  3473.             When on calls in the budcalls list will be ignored.
  3474.  
  3475.        IMport filename
  3476.             Imports messages from the given file.  The file must follow the
  3477.             form of the files in the mail.bak directory.
  3478.  
  3479.        INitpr [on/OFF]
  3480.             Command allows you to specify if printer should be initialized
  3481.             before each file is printed.  Set it to ON if you need the
  3482.             initialization.  If you need to press buttons (to select draft
  3483.             or letter quality mode for example) that you don't want cleared
  3484.             before each file, set it to OFF.
  3485.  
  3486.        IPNCheck number
  3487.             Inactivity timeout in seconds for TCP/IP connections, default
  3488.             600.
  3489.  
  3490.        IPNFrack number
  3491.             Retry timer in seconds for TCP/IP connections, default 30.
  3492.  
  3493.        IPNRetry number
  3494.             Retries for TCP/IP connections, default 5.
  3495.  
  3496.        IPTtl number
  3497.             Sets TCP/IP time to live value. This is the number of times a
  3498.             TCP/IP frame will get relayed before it gets discarded. Default
  3499.             is 16.
  3500.  
  3501.        JBbs [port#]
  3502.             Lists BBSs heard and their paths for given port or on all ports
  3503.             if no port number is given.
  3504.  
  3505.        JDigipeat [port#]
  3506.             Lists Digipeaters heard and their paths for given port or on all
  3507.             ports if no port number is given. JD command screens out invalid
  3508.             callsigns.
  3509.  
  3510.        JGateways [port#]
  3511.             Lists Gateways heard and their paths for given port or on all
  3512.             ports if no port number is given.
  3513.  
  3514.        JHeard [port#]
  3515.             Lists stations heard and those connected to BBS or PBBS  This
  3516.             command gives a list of the last 10 stations that were heard on
  3517.             the ports or connected to the BBS or PBBS. If a port number is
  3518.             given only stations heard on that port are listed. An asterisk
  3519.             after a callsign indicates that the station was heard through a
  3520.             digipeater.
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.        MSYS 1.18                                                   Page 49
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.        JKanodes [port#]
  3534.             Lists KANode beacons heard and their paths for given port or on
  3535.             all ports if no port number is given.
  3536.  
  3537.        JMsys [port#]
  3538.             Lists other MSYS systems' beacons heard for given port or on all
  3539.             ports if no port number is given.
  3540.  
  3541.        JNetrom [port#]
  3542.             Lists NET/ROM node beacons heard and their paths for given port
  3543.             or on all ports if no port number is given.
  3544.  
  3545.             NOTE for all the J commands: These commands give the PBBS
  3546.             systems, KANodes and other beacons that have been heard on the
  3547.             ports.  A BBS is a system that sends out a beacon that contains
  3548.             /B after what looks something like a callsign.  A KANODe is
  3549.             identified by /N in its beacon to ID.  For both of these
  3550.             commands the date, time, callsign and path are given.  This pair
  3551.             of commands is useful to identify the PBBS that goes with a
  3552.             given KANODe.  The Net nodes are also included.  The real call
  3553.             for such nodes are given in [ ].  Real NetRoms get the real call
  3554.             in { }.
  3555.  
  3556.        JTcp/ip [port#]
  3557.             List TCP/IP stations heard and their addresses for given port or
  3558.             on all ports if no port number is given.
  3559.  
  3560.        KEyboard chan#
  3561.             The KEyboard command allows you to manually reassign the
  3562.             keyboard.  As a parameter you give the channel number of the
  3563.             process you want to have the keyboard.  You can get the channel
  3564.             number from the lower right part of the F1 screen.  To get the
  3565.             keyboard back to the command processor so you can issue this
  3566.             command either press ^F6 to assign the keyboard to the command
  3567.             processor or press F6 to temporarily send keyboard input to the
  3568.             command process up to and including the next return key.  When
  3569.             you press a key, it is placed in the input buffer of the process
  3570.             to which the keyboard is logically connected.  Initially this is
  3571.             the command process.  When you give certain commands (such as
  3572.             BB, PB, C) the keyboard will be assigned to the new process
  3573.             created for the command.  When the process is terminated, the
  3574.             keyboard is automatically assigned back to the command
  3575.             scheduler.
  3576.  
  3577.  
  3578.        KILLproc process#
  3579.             Abort specified process number (Can be hazardous!). Never use
  3580.             this command to kill a permanent process.  Better yet, just
  3581.             don't use this command! Process numbers can be viewed using the
  3582.             PROcess command.
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.        MSYS 1.18                                                   Page 50
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.        KPorts [MASK]
  3595.             This command allows you to selectively disable the K-node on any
  3596.             ports.
  3597.             A one bit for a given port number enables the K-node on that
  3598.             port.
  3599.  
  3600.        LCount filename
  3601.             This command counts the number of lines, characters and words in
  3602.             a given file.  Note: This is NOT the LC command found in the
  3603.             bbs.
  3604.  
  3605.        LOCKkbd
  3606.             This command "locks" the keyboard so that any keys pressed are
  3607.             ignored.  I put it in for two reasons.  First, I am getting RF
  3608.             into my keyboard from HF radios and it generates random
  3609.             characters.  Second, my 3 year old son sometimes likes to press
  3610.             the keys.  To "unlock" the keyboard, simply type "lock" again
  3611.             (no CR needed this time).  When unlocking the keyboard, "lock"
  3612.             must be all LOWER case.
  3613.  
  3614.        LOGclose
  3615.             This command closes the log file, renames it to form of
  3616.             yymmdd.LOG and then opens a new log file.  Caution:  Do NOT use
  3617.             more than once per day!
  3618.  
  3619.        LUsers
  3620.             Use this command to see who has connected and more importantly
  3621.             how many users are in the user file since it can hold only 500
  3622.             users currently.  LU takes an optional argument to list users
  3623.             flagged as BAD, EXPert, LIMited, LOCked, XFAst, NEW and BBS
  3624.             system.  Example: LU EXP
  3625.             LU RESET clears all new user flags.
  3626.  
  3627.        MAKEPrivate [ON/OFF]
  3628.             Sets/resets making personal messages private by default.
  3629.  
  3630.        MAStersrv hierarchical-address
  3631.             Specifies the master WP server (default is
  3632.             N6IYA.#NOCAL.CA.USA.NOAM and probably shouldn't be changed).  If
  3633.             MAS is set to NONE, no WP messages will be sent.
  3634.  
  3635.        MAXBullage number
  3636.             This command may be used to discard bulletins older than a
  3637.             specified amount as soon as they are received.  Default age is
  3638.             32000.  A reasonable value might be 21 days.  Bulletin age is
  3639.             determined by the date on the last R: line found in the
  3640.             bulletin.  If MAXBullage is set to a negative number, bulletins
  3641.             older than the number given (in days) will be held rather than
  3642.             discarded.
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.  
  3649.        MSYS 1.18                                                   Page 51
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.        MAXFOrward [Port#] # bytes
  3656.             This command permits you to set the largest message size that
  3657.             will be forwarded on a port.  This may be useful for HF
  3658.             forwarding.
  3659.  
  3660.        MAXFrames number
  3661.             Display or change number of frames (1 to 7) sent before waiting
  3662.             for and ACK (RR) to be received. A value of 4 is generally good
  3663.             for VHF ports. Use 1 or 2 on HF ports. For very good vhf paths
  3664.             and RS-232 wire links, 7 may be a good value.
  3665.  
  3666.        MAXRead [port#] number
  3667.             Specifies maximum size message that can be read or file that can
  3668.             be downloaded. If no port number is specified value applies to
  3669.             all ports.
  3670.  
  3671.        MCForward [MASK]
  3672.             Allows you to control Multiple Connections during Forwarding.
  3673.             The operand for this command is a port bit mask.  Default is all
  3674.             1's in the mask which allows forwarding to go on as in previous
  3675.             versions.  If a particular port has its bit set to 0, then
  3676.             forwarding on that port is counted as a BBS connect on that
  3677.             port.  Thus if you have BMaxcon set to 1 for that port and you
  3678.             are forwarding on that port, a BBS connect will not be allowed
  3679.             (since you are already using the port).  Also, if there are
  3680.             already BMaxcon BBS connections for that port forwarding will be
  3681.             bypassed for that port.  Careful use of these commands should
  3682.             reduce the congestion on HF forwarding as you now have complete
  3683.             control over the level of multiconnection for both BBS and
  3684.             forwarding activities combined.  In the [MASK] argument you put
  3685.             1's in the ports on which you want forwarding to be counted as a
  3686.             BBS connect.  Using MCF along with BM (and BP if you have marked
  3687.             any stations as BBSs), allows you to limit a given port to a
  3688.             single BBS connect or forward at a time.  If you want this on
  3689.             port 0, use the following:
  3690.             MCF $FE
  3691.             BM 0 1
  3692.             BP $01
  3693.  
  3694.        MCOn [number]
  3695.             Specifies number of connects allowed to the SYSOP keyboard at
  3696.             one time if MCon 1, only allows an incoming call to the key
  3697.             board to be answered if there are no other keyboard connections.
  3698.             MCOn 0 prevents all incoming keyboard requests.
  3699.  
  3700.        MDir directoryname
  3701.             Makes specified directory.
  3702.  
  3703.        MEMory
  3704.             Displays amount of memory free.  This number may not include the
  3705.             amount of memory available in the "holes" created by stations
  3706.             disconnecting.
  3707.  
  3708.  
  3709.  
  3710.        MSYS 1.18                                                   Page 52
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.        MERge
  3717.             This command reads MSYSFWD.DEF and copies it to MSYS.FWD,
  3718.             expanding any include files ($filename).  A new file is also
  3719.             produced, MSYS.BBS that is a sorted list of all possible BBSs
  3720.             that can be forwarded to (including things like ARRL, 44*,
  3721.             etc.).  This command was added for 2 reasons: previously, if
  3722.             there were any include files in the MSYS.FWD files they did not
  3723.             get read when a PF command was used and secondly, the new file
  3724.             is needed for hierarchical forwarding.  The leftmost part of the
  3725.             hierarchical route only is used for forwarding and the contents
  3726.             of the new file were needed for efficient processing.  So, the
  3727.             bottom line is rename your existing MSYS.FWD file to MSYSFWD.DEF
  3728.             and then use the MERge command.  Any future changes you make to
  3729.             your forward file must be done to MSYSFWD.DEF followed by use of
  3730.             the MERge command.  Its called MERge because it merges in the
  3731.             include files.
  3732.  
  3733.        MEXpert [on/OFF]
  3734.             If on, the message of the day will be displayed to all non-BBS
  3735.             marked stations.  If off, it will only be displayed to non-
  3736.             expert, non-BBS stations.
  3737.  
  3738.        MHclear [letter [port or B]]
  3739.             Clears the various J heard lists. Letters are HBKDN or G
  3740.             (Heard, BBSs, K Nodes, Digi's, NetRoms).  Examples:
  3741.             MH        clears everything.
  3742.             MH D      clears all Digi's heard
  3743.             MH D 1    clears Digi's heard on port 1
  3744.  
  3745.        MIDchar string
  3746.             Message ID indicator (max 4 chars) to be sent in SID. If non-
  3747.             blank, MIDS will be sent for private messages when forwarding to
  3748.             systems that have the same string in their SID (System
  3749.             IDentifier, the stuff in [ ] when a connect is made to a BBS).
  3750.  
  3751.        MINmem number
  3752.             Allows specification of the minimum free memory as reported by
  3753.             the MEM for which a new connect request will be accepted.
  3754.             Default is 32000.  Values less than 16000 probably will be
  3755.             disastrous. A value of 32000 or more is strongly recommended,
  3756.             particularly if you are using compressed forwarding.
  3757.  
  3758.        MISsing
  3759.             Reports number of times forwarding aborted due to missing text
  3760.             file.
  3761.  
  3762.        MONBframe [ON/off]
  3763.             Enable/disable monitoring of Beacon (UI) frames
  3764.  
  3765.        MONCC [ON/off] - enables/disables monitoring of TCP/IP packets
  3766.  
  3767.        MONCF [ON/off] - enables/disables monitoring of NetRom packets
  3768.  
  3769.  
  3770.  
  3771.        MSYS 1.18                                                   Page 53
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.        MONIFrame [ON/off]
  3778.             Enable/disable monitoring of Information frames
  3779.  
  3780.        MONITor [ON/off]
  3781.             This is the master command for monitoring packets heard.  If
  3782.             this is set to OFF then there will be no monitoring.  If set to
  3783.             ON then the types of packets selected will be monitored for
  3784.             calls as selected by BUDCalls on the ports set by MONPorts.
  3785.  
  3786.        MONOutgoing [ON/off]
  3787.             Enable/disable display of outgoing frames
  3788.  
  3789.        MONPorts [MASK]
  3790.             This command is used to enable or disable monitoring of the
  3791.             various ports on the F2 screen.  See the section on MASK on how
  3792.             to set the mask for the desired ports.
  3793.  
  3794.        MONSframe [ON/off]
  3795.             Enable/disable monitoring of Supervisory frames (RR, RNR, REJ).
  3796.  
  3797.        MONUframe [ON/off]
  3798.             Enable/disable monitoring of unnumbered frames (SABM, UA, DISC,
  3799.             DM)
  3800.  
  3801.        MONxx
  3802.             Specifies any hex value for PIDs to ignore on screen 2
  3803.             monitoring. Example: MONCC ON  would enable monitoring of frames
  3804.             with PID of CC
  3805.             Note: You must specify exactly two hex digits
  3806.  
  3807.        MSgtrailer [ON/off]
  3808.             If on when a message is read on the BBS (except with RN or RE) a
  3809.             line is sent at the end of the message indicating its number and
  3810.             who it was from.  (Default is ON)
  3811.  
  3812.        MYAlias string
  3813.             Display or change BBS alias callsign. Must be 1 to 6 characters,
  3814.             no SSID.
  3815.  
  3816.        MYBbs callsign
  3817.             Display or change BBS primary callsign. Can have SSID.
  3818.  
  3819.        MYCall callsign
  3820.             This command displays your keyboard callsign if there is no
  3821.             argument, or sets the keyboard callsign (used to connect and
  3822.             respond to connects) to the call given as an argument (including
  3823.             SSID).
  3824.  
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.        MSYS 1.18                                                   Page 54
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.        MYIpaddr ip-addr
  3839.             Takes four integers each in the range 0 to 255.  It sets the IP
  3840.             address that the system will respond to.  Example: MYI 44 70 4 6
  3841.             If MYIpaddress is not specified, or set to all zeros, the TCP/IP
  3842.             support will be inactive.
  3843.  
  3844.        MYKnode callsign
  3845.             Display or change K-node callsign. Should have SSID.
  3846.  
  3847.        MYTcpcall callsign
  3848.             Display or change a callsign (with SSID) that will be used when
  3849.             sending ARP and TCP/IP frames.  It should be the same as the
  3850.             network node call in most cases.
  3851.  
  3852.        NBdcast [port#] [ON/off]
  3853.             If OFF, node broadcasts will not go out on port, but the node
  3854.             will otherwise operate on the port (assuming it is enabled using
  3855.             NP and other commands).
  3856.  
  3857.        NDwindow number
  3858.             Network default window size in frames. Default is 4. Note that
  3859.             his has nothing to do with windows on the screen.
  3860.  
  3861.        NETBbs (ON/off)
  3862.             Enable/Disable BBS command in network node.
  3863.  
  3864.        NETCon (ON/off)
  3865.             Enable/Disable Connect command in network node.
  3866.  
  3867.        NETFBBC number  NET/ROM FBB Compatibility Flag
  3868.             0 = No FBB style forwarding (Default)
  3869.             1 = Uncompressed FBB forwarding protocol
  3870.             2 = Compressed FBB forwarding protocol
  3871.             This option only has meaning when connected to FBB compatible
  3872.             systems through the network node.
  3873.  
  3874.        NETFBBG number
  3875.             Sets maximum number of messages included in a group when
  3876.             forwarded using network  (1-5 messages per forward group)
  3877.             This option only has meaning when connected to FBB compatible
  3878.             systems through the network node.
  3879.  
  3880.        NETFBBStime [hourlist]
  3881.             Allows specification of hours BBS is full function when accessed
  3882.             through the network.  Default is 0-23 which is all the time.
  3883.             Hour list has same format as that used in the ! lines in the
  3884.             forwarding file.
  3885.  
  3886.        NETNode [ON/OFF]
  3887.             Enables the Network Node
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.        MSYS 1.18                                                   Page 55
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.        NETOnly [on/OFF]
  3900.             This command is used to indicate if BBSs only or any stations
  3901.             can connect to the BBS via the network.  If ON, only BBSs are
  3902.             allowed to connect via the network.  If OFF, then any station
  3903.             can connect to BBS via network.
  3904.  
  3905.        NETRead number
  3906.             Specifies maximum size message that can be read or file that can
  3907.             be downloaded when connected to the BBS through the network.
  3908.  
  3909.        NETTalk (ON/off)
  3910.             Enable Talk command in the network node.
  3911.  
  3912.        NEWUser number
  3913.             Allows you to set the initial user flags for all new users (see
  3914.             EUuser command for the bit position meanings).  Thus you can
  3915.             choose to make new users limited (or I suppose for a closed
  3916.             board, "bad users") until they identify themselves somehow.
  3917.  
  3918.        NETXBatchsize
  3919.             Sets the number of uncompressed bytes available for RLI
  3920.             compressed forwarding via the network port.
  3921.  
  3922.        NETYapp [on/OFF]
  3923.             Enables YAPP (Yet Another Packet Protocol used for binary file
  3924.             transfer between user and BBS) for connections made to the BBS
  3925.             through the network.  Users must be enabled with user bit $800
  3926.             to be able to upload files.
  3927.  
  3928.        NInfo
  3929.             Gives network node status display. Same output as U * command
  3930.             from in the network node.
  3931.  
  3932.        NNode [window#]
  3933.             This command takes you into the NODe as if you had connected to
  3934.             it.  When in the NODe you can issue SYSOP commands if you need
  3935.             to by putting \ or / in front of them as you can in the BBS.
  3936.             Particularly useful are the NODe, DEStination and REMove
  3937.             commands when in the NODe to modify neighbor nodes and
  3938.             DEStination nodes. You can optionally specify a window number to
  3939.             use (4 might be a good one).
  3940.  
  3941.        NODETimeout number
  3942.             Number of seconds of inactivity on network node or K node at
  3943.             command prompt to disconnect user.  Default is 300 seconds (5
  3944.             minutes).
  3945.  
  3946.        NOBEacons [mask]
  3947.             If a given port is set to 1 then there will be no ID, mail for,
  3948.             or BText beacons.
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.        MSYS 1.18                                                   Page 56
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.        NOBUlls (on/OFF)
  3961.             When on, no bulletins will be forwarded during normal
  3962.             forwarding.  Useful in clearing backlog of messages,
  3963.             particularly during earthquakes and hurricanes!
  3964.  
  3965.        NODe ADD [nodeid:]call port quality [digi1 [digi2 ... [digi8]]]
  3966.             Adds neighbor network node using given port and quality
  3967.  
  3968.        NODe DEL call port
  3969.             Deletes neighbor nodes & its DESts
  3970.  
  3971.        NODe REP [nodeid:]call port quality [digi1 [digi2 ... [digi8]]]
  3972.             Changes quality of neighbor network node
  3973.  
  3974.        NODe REStore
  3975.             Read net NODe Database from disk. If you are using the network
  3976.             node, you would probably put this command in your MSYS.DO file.
  3977.  
  3978.        NODe SAve
  3979.             Write network node Database to disk.
  3980.  
  3981.        NODe SEnd
  3982.             Force known network node destination broadcast.
  3983.  
  3984.        NPorts [mask]
  3985.             Ports to which network node broadcasts are made. Default is 0.
  3986.  
  3987.        NRCall [callsign]
  3988.             Sets net work mode callsign. It should have an SSID.  Example:
  3989.             NRC WA8BXN-2
  3990.  
  3991.        NRId [mnemonic]
  3992.             Sets net NODe mnemonic identifier for network node.  Example:
  3993.             NRI 460406
  3994.  
  3995.        NTtl [number]
  3996.             Network node time to live (max hops). Default is 64.
  3997.  
  3998.        OCInit [number]
  3999.             Initial obsolescence count for network node. Default is 6.
  4000.  
  4001.        OCMin [port#] [number]
  4002.             Minimum obsolescence to broadcast a destination node in network
  4003.             node broadcast.  OCM is settable for each port. Default 10
  4004.  
  4005.        OKfrom List of acceptable non-calls for originating station (Maximum
  4006.             80 characters). Default is: WP REQWP.
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.        MSYS 1.18                                                   Page 57
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.        PAClen [port#] [number]
  4022.             Specifies maximum number of bytes that are put in a packet
  4023.             before it is sent.  Possible range of values is 1 to 255. If
  4024.             packets will go through a network node on their way to their
  4025.             destination 236 should be used. On HF a value of 40 is generally
  4026.             good.
  4027.  
  4028.        PATh callsign
  4029.             Displays information about given user callsign (same as P on
  4030.             BBS)
  4031.  
  4032.        PC [on/OFF]
  4033.             This command enables or disables the on-line Callsign Server.
  4034.  
  4035.        PForward callsign
  4036.             Displays information about given BBS callsign (same as PF on
  4037.             BBS)
  4038.  
  4039.        PIng destination
  4040.             Where destination is either an IP address like [44.70.4.6.] or a
  4041.             mnemonic defined in MSYSHOST.NET.  The reply comes in window 2
  4042.             (where the connect and disconnect messages appear)and gives the
  4043.             round trip time in seconds.
  4044.  
  4045.        PMessage message#
  4046.             This will print the given message.  If you have MAIL.BAK as a
  4047.             directory then the file MAIL.BAK/MSG###.DAT will be printed.
  4048.             This will look nice.  If you don't, then MAIL/MSG###.DAT will be
  4049.             printed.  This will be only the message text.  This command just
  4050.             makes it easier to print a message than using the PRInt command.
  4051.  
  4052.        POrts [port#] [ON/OFF]
  4053.             Various information is given by this command if no operands are
  4054.             specified.  Interesting to look at but may not be very useful.
  4055.             POrt can have operand on/off.  When off a port will not respond
  4056.             to the id callsign (with any SSID) and will no longer digipeat
  4057.             or be usable from the KANODe.  BBS will not id unless you use
  4058.             it.  Id will be very short if it has to id (no text for the UI
  4059.             frame).If you call a station with the port off this will still
  4060.             work because incoming packets from that station don't include a
  4061.             connect packet.If you give a PO [port#] with no operand, the
  4062.             port will be turned off.
  4063.  
  4064.             The POrts command will take a single parameter (ON or OFF) in
  4065.             addition to an optional port number.  With just the single
  4066.             parameter, all ports are turned on or off.  Useful when you want
  4067.             to shut down the system.  PO OFF allows the current users to
  4068.             finish while preventing further connects.
  4069.  
  4070.  
  4071.  
  4072.  
  4073.  
  4074.  
  4075.  
  4076.        MSYS 1.18                                                   Page 58
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.        PPersist [port#] value
  4083.             Sends number given to TNC 255 to 0 as persistence value.
  4084.             Basically the higher the number the more likely the TNC will
  4085.             actually transmit a frame (if it has one to transmit) when it
  4086.             hears the channel is clear. Better overall channel throughput
  4087.             will result if all stations use a moderate value of persistence
  4088.             (50 to 100). A value of 255 says to transmit as soon as the
  4089.             channel is clear.
  4090.  
  4091.        PQuality [port#] number
  4092.             Default is 192. Sets quality for network nodes heard on port.
  4093.  
  4094.        PRInt [filename]
  4095.             Prints a file (on printer) The argument is the pathname to the
  4096.             file to print.  Make sure the drive is ready before using this
  4097.             command.  Make sure the printer is ready (and exists) before
  4098.             using this command.  Printing is done to LPT1: via BIOS calls.
  4099.             This command will queue up to 25 print requests.  PRInt with no
  4100.             operands lists the files in the queue.
  4101.  
  4102.        PROcesses
  4103.             This command displays for each active process its number,
  4104.             program running for that process, an integer parameter passed to
  4105.             the process (usually a port or channel number), the least amount
  4106.             of memory left in the stack for the process (labeled SPmin), and
  4107.             the window used for output by the process.  Of particular
  4108.             importance is SPmin if the system does bizarre things.  If this
  4109.             number is less than say 100 the stack is too small.  If its a
  4110.             negative number, you have problems for sure!
  4111.  
  4112.        PRTmsgs (on/OFF)
  4113.             Enables printing of all incoming messages as they are received.
  4114.  
  4115.        PScan [port#] |[freq]
  4116.             Enables the PACTOR scanning routines
  4117.  
  4118.        PWindow number number
  4119.             If given one parameter this command displays the name and window
  4120.             used by the given process number.  If two numbers are given as
  4121.             parameters, the first is the process and the second number is
  4122.             the window number to assign to that process.
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.        MSYS 1.18                                                   Page 59
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.        Qmsg msg#
  4144.             This command copies the given message file to a file called
  4145.             QMSG, stripping off the R: lines, and inserting > at the
  4146.             beginning of each line.  It then takes you into the editor to
  4147.             edit the file QMSG.  You may now respond to the quoted message
  4148.             text adding and deleting lines as desired.  Editor help is
  4149.             available with Esc HELP.  When you are done editing, save the
  4150.             file (Esc SAVE).  Next go into the bbs and use the REP command
  4151.             to begin replying to the message.  Instead of typing your reply,
  4152.             use the \+\QMSG to include the edited quoted message.  When it
  4153.             has been read, type the ^Z or /EX to signal the end of your
  4154.             message.  If the command is done from within the bbs by using
  4155.             the form /QM, the bbs will prompt your entries for sending the
  4156.             message.
  4157.  
  4158.        QUIT
  4159.             After you use QUIT command (or Ctrl/F4) the screen is cleared.
  4160.             JK etc. information is saved when you do a QUIT and reloaded
  4161.             when BBS is started again.
  4162.  
  4163.        RBid [on/OFF]
  4164.             When on, will take the received BID/MID ($:xxxxxx) and insert it
  4165.             in the current R: line.
  4166.  
  4167.        RDir directoryname
  4168.             REMove specified directory
  4169.  
  4170.        Readbackup number
  4171.             This command allows you to read a message in the MAIL.BAK
  4172.             directory (if it exists).     Example: RE 12345
  4173.  
  4174.        REMove DESt callsign
  4175.             Deletes specified destination network node through all
  4176.             neighbors.
  4177.  
  4178.        REName Oldpathname newpathname
  4179.             Renames a file. Both name must be on same drive.
  4180.  
  4181.        REPlaces
  4182.             Reads BBS call/@BBS replace file and stores it in memory. Use
  4183.             this command every time you modify the MSYS.REP file while MSYS
  4184.             is running.
  4185.  
  4186.        REQDIR [on/OFF]
  4187.             Enables Request directory server in the BBS.
  4188.  
  4189.        REQFIL [on/OFF]
  4190.             Enables Request File server in the BBS.
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.        MSYS 1.18                                                   Page 60
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.        REQMaxfile number
  4205.             Used to set a limit on the size of files that may be requested
  4206.             from the REQFIL server and also the files that will be displayed
  4207.             in REQDIR requests.  The default is 5000 which is probably too
  4208.             high.
  4209.  
  4210.        REQQTH [on/OFF]
  4211.             Enables Request QTH server in the BBS.
  4212.  
  4213.        RESPonsetime #  Where # is the number of seconds to wait before
  4214.             sending out a response.  This is the T2 timer value in the AX.25
  4215.             spec.  If you set RESP to 0 it will work the old way, always
  4216.             sending out a response to each I frame received as soon as
  4217.             possible.  With non-zero values for RESP, the responses are
  4218.             held, the  latest one replacing any one being held, until no  I
  4219.             frames have been received for the time given.  It then  sends
  4220.             out its response.  RESPonstime Can be set for individual ports.
  4221.  
  4222.        RESTore <arguement>  Restores a message from the MAIL.BAK dir to the
  4223.             active mail directory specified by the arguement.  IT DOES NOT
  4224.             maintain the old number, but assigns a new MESSAGE number.  It
  4225.             WILL maintain the original BID (if any).
  4226.             Possible arguements:
  4227.                  msg#      restores a given message number
  4228.                  msg# msg# restores all messges in given range of numbers
  4229.                  Missing   restores messages that exist in MAIL directory
  4230.             but don't have headers.
  4231.  
  4232.             NOTE: This command may now be done as a SYSOP command OR from
  4233.             within the BBS.  BBS Example:      /REST 12345
  4234.  
  4235.        RETries number
  4236.             Displays or sets number of retries before disconnecting. A value
  4237.             of 5 is good for VHF, 10 can be used on HF.
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.        MSYS 1.18                                                   Page 61
  4260.  
  4261.  
  4262.  
  4263.  
  4264.  
  4265.        RLinetime [#]
  4266.             Given number of hours are added to the computer clock to
  4267.             generate date/time in R: lines added to messages. Used to
  4268.             correct R: line time to "Z" time.  MSYS remains on
  4269.             local/computer time. Mutually exclusive with GMTimeoffset.
  4270.  
  4271.        RUn programname
  4272.             Allows you a DOS program with many limitations.  For those of
  4273.             you who have asked for some sort of DOS shell capability you may
  4274.             recall I have said it can't be done.  But some of you said all
  4275.             you needed to do was output 8 bits to some port or something
  4276.             like that.  Well if you have something VERY SIMPLE and VERY
  4277.             SMALL and very QUICK here is something that should work for you.
  4278.             Note: You must follow all of the rules given here or very
  4279.             strange things might happen for which I claim no responsibility.
  4280.             If you use the RUn command and it doesn't work it is clearly you
  4281.             who have made the error!  Here are the rules for programs you
  4282.             might consider using with the run command (if you don't
  4283.             understand these rules or aren't sure your program complies with
  4284.             them, don't run it!):
  4285.  
  4286.             1. Program must be small (I'd say under 10K).  If you get a
  4287.                  message that says not enough memory, the program is too
  4288.                  big.
  4289.             2. Program must be in default MSYS directory.
  4290.             3. Program must be fast.  If runs much over 1 minute, the system
  4291.                  will reboot.  While it is running no packets of any kind
  4292.                  will be transmitted.
  4293.             4. Programs should not use any of the "standard" pre-opened
  4294.                  files.  Console I/O must be done using ROM BIOS only.  If
  4295.                  you open any files, you must close them.  If you use any
  4296.                  memory, you must free it.  If you change anything in the
  4297.                  computer you must put it back for the most part.
  4298.             5. Any screen output will be put in a file called $POOL.  The
  4299.                  TYpe command may be used to view the file.
  4300.             6. You should write your programs in either assembly language or
  4301.                  C.  Here is an example of a C program that is suitable for
  4302.                  framing (I mean execution using the RUn command):
  4303.  
  4304.                  #include <stdio.h>
  4305.                  #include <stdlib.h>
  4306.                  main(int argc, char *argv[])
  4307.                  {
  4308.                   int I;
  4309.                   char *path;
  4310.                   path = getenv("PATH");
  4311.                   for (i=0;i<argc;i++)
  4312.                     cprintf("argv[%d] is '%s'\n",i,argv[i]);
  4313.                   if (path) cprintf("Path = '%s'\n",path);
  4314.                   exit(1);/* You didn't expect this to do anything useful I
  4315.                  hope*/
  4316.                   }
  4317.  
  4318.  
  4319.  
  4320.        MSYS 1.18                                                   Page 62
  4321.  
  4322.  
  4323.  
  4324.  
  4325.  
  4326.        SCreensave number
  4327.             If the number given is zero (which is the default) the screen
  4328.             will not be blanked automatically.  The method used to blank the
  4329.             screen will work with all display cards (the screen content is
  4330.             saved and then blanks are written to the screen).  When you
  4331.             press a key to unblank the screen you will always get to screen
  4332.             1 (the one you get with the F1 key).
  4333.  
  4334.        SEnd <chan#> <message>
  4335.             Parameters are an active channel number and the text of the
  4336.             message to send.  The text is prefixed with "MESSAGE FROM SYSOP
  4337.             AT id-callsign".  Use this to give helpful hints to users you
  4338.             see that are in trouble with the commands they are trying to
  4339.             use.  If you wish to NOT send the "MESSAGE.FROM..." verbage, use
  4340.             the form:   SE- <chan#> <message>
  4341.  
  4342.        SHUTdown [on/OFF]
  4343.             When on, will send shutdown in progress message to users.  Does
  4344.             NOT affect bbs connects or forwarding.  Forwarding should be
  4345.             ABorted and incoming bbs connects and network connects should be
  4346.             DISConnected on a per channel basis.
  4347.  
  4348.        SLottime [port#] value
  4349.             Sends the given value (0 to 255) to the TNC. This value is used
  4350.             in conjunction with PPersist. For more information consult your
  4351.             TNC manual.
  4352.  
  4353.        SMTP
  4354.             Allows local access to the SMTP server (mainly for test
  4355.             purposes).  The data channel port number for SMTP transfers is
  4356.             not correctly displayed.  It does not affect operation and may
  4357.             be fixed in a future release.
  4358.  
  4359.        SNow  [on/OFF]
  4360.             If you have a CGA adapter and there is a lot of snow during
  4361.             screen changes (particularly when changing display pages with
  4362.             F1-F4) and you don't like it, set SNow to ON.  Otherwise leave
  4363.             it off and the display will run faster.
  4364.  
  4365.        SOrt filename
  4366.             Useful to sort your forward include files in the /fwd directory
  4367.             so you can find things there more easily.  Will sort up to 200
  4368.             eighty byte records.
  4369.  
  4370.  
  4371.  
  4372.  
  4373.  
  4374.  
  4375.  
  4376.  
  4377.  
  4378.  
  4379.  
  4380.  
  4381.        MSYS 1.18                                                   Page 63
  4382.  
  4383.  
  4384.  
  4385.  
  4386.  
  4387.        STatus <option>
  4388.             With no option, it displays the status of active channels,
  4389.             buffer space/errors on serial ports and dispatches per second.
  4390.  
  4391.             OPTIONS:
  4392.                  RESET     Clears counters, sets dispatch values to last
  4393.                            minute value.
  4394.                  Channel   Displays only information on active channels
  4395.                  Ints      Displays information about interrupts received
  4396.                  Stats     Displays only buffer space/errors on serial ports
  4397.                            and dispatches per second info.
  4398.  
  4399.             I put this one in for my own debugging (like some of the other
  4400.             information displays).  FREE is what is currently free in the
  4401.             buffer used to get characters from the TNC (an interrupt driven
  4402.             routine is used).  LEAST is  the smallest amount  of space that
  4403.             was available.  If least is small (say less than 100) you've got
  4404.             some real problems.  I don't think I've ever seen it go below
  4405.             3000.  If it is small it means that characters are coming from
  4406.             the TNC faster than they are being processed.  You might try a
  4407.             lower baud rate between the computer and TNC but this probably
  4408.             won't really help the situation much.  Dispatches per second is
  4409.             how many times per second each process was given control of the
  4410.             CPU.  If this goes to zero I'd worry a lot!  Note: will only
  4411.             display information for real ports.
  4412.  
  4413.        SUspendtrace number
  4414.             Where number is the number of free bytes in the input buffers
  4415.             below which the monitoring is turned off.  There is 1 buffer of
  4416.             4096 bytes for each serial port (tnc).  The amount free at any
  4417.             time is given by the STatus command.  When the free space gets
  4418.             less than the SU value, F2 monitoring is turned off to allow
  4419.             things to get processed more quickly.  Default value is 2000
  4420.             bytes.  Again, F2 displays take a lot of time and when the
  4421.             system gets behind it is a good idea to turn off the updating of
  4422.             the display.  When the free space in all the buffers goes above
  4423.             the SU value tracing is turned back on (unless otherwise
  4424.             suspended).  This function can be effectively disabled by
  4425.             setting SU to 0 and then it will work as before.
  4426.  
  4427.        SYsop [ON/off]
  4428.             If on, messages to SYSOP will be included inthe "You have ...
  4429.             messages" on the F1 screen display.
  4430.  
  4431.        TABs [ON/off]
  4432.             when on tabs are expanded on local display; when off a tab shows
  4433.             up as ^I.  Default is ON.
  4434.  
  4435.        TACk [number]
  4436.             Transport ack delay in seconds for network node. Default is 3.
  4437.             Similar in function to RESPonsetime but for network node.
  4438.  
  4439.  
  4440.  
  4441.  
  4442.        MSYS 1.18                                                   Page 64
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.        TBdelay [number]
  4449.             Transport busy delay in seconds for network node. Default is
  4450.             180.
  4451.  
  4452.        TElnet host-id [server#]
  4453.             Takes an IP address (or host mnemonic) and optional server
  4454.             number as parameters.
  4455.             Examples:
  4456.                  TE [44.70.4.10]
  4457.                  te eiw    (eiw would have to be defined in MSYSHOST.NET)
  4458.             NOTE: To allow Telnet access to your BBS, you must modify the
  4459.             entries in your MSYSHOST.NET file.  Basically you must add the
  4460.             call (without SSID) in square brackets of those stations that
  4461.             are to be allowed BBS access.  Example:
  4462.  
  4463.             44.70.4.5 eiw K8EIW      #this IP address would not have access
  4464.                                      to the BBS
  4465.             44.70.4.32 [k8eiw] don   #this IP address would have access to
  4466.                                      the BBS
  4467.             Note: You can use any case within the [ ], do NOT use any
  4468.             SSID's!
  4469.  
  4470.        TERM [port#]
  4471.             This command connects the keyboard directly to the port so that
  4472.             you may access a tnc or modem.   It may be useful for resetting
  4473.             parameters in the modem or tnc.  There are two F-keys that may
  4474.             be used while in this command.  The F9 key will send a sequence
  4475.             which should take a tnc out of the KISS mode.  The F10 key exits
  4476.             the term mode.  When leaving the term mode, make sure that tnc's
  4477.             are in the KISS mode, or <PACTOR/GTOR STANDBY> mode.  Modems
  4478.             should be left in the auto answer mode.  While in the TERM
  4479.             command, the keyboard can not be used for other functions within
  4480.             MSYS (F6 key), nor will input from the port be visible on the F2
  4481.             screen.  There is no recording or sending of included files
  4482.             (\+\)and there are no plans to add them.
  4483.  
  4484.        TFrames Port#
  4485.             Send test frames on a given port each time enter is pressed. Use
  4486.             Esc key to terminate.
  4487.  
  4488.        TImezone [string]
  4489.             Allows entry of your time zone.  Set timezone GMT to all caps to
  4490.             get lower case z on message time R: lines.
  4491.  
  4492.        TNatime [number]
  4493.             Network node Transport no activity timeout time in seconds.
  4494.             Default is 600.
  4495.  
  4496.  
  4497.  
  4498.  
  4499.  
  4500.  
  4501.  
  4502.  
  4503.        MSYS 1.18                                                   Page 65
  4504.  
  4505.  
  4506.  
  4507.  
  4508.  
  4509.        TOdo
  4510.             Causes the MSYSTODO.DAT file to be scanned immediately, doing
  4511.             anything it is time to do and also setting the time of the next
  4512.             thing to do.
  4513.  
  4514.             NOTE: Be sure to use this command every time you change
  4515.             MSYSTODO.DAT while MSYS is running!
  4516.  
  4517.        TPorts [MASK]
  4518.             This number is used the same way as other similar commands:
  4519.             When the bit is set to 1 for a given port, that port is
  4520.             available for TCP/IP use (particularly ARP broadcasts).
  4521.  
  4522.        Trace25 [ON/OFF]
  4523.             Enables/disables traces of AX.25 packets.  If you set it on you
  4524.             will get more stuff that you can't understand faster than you
  4525.             ever wanted to see it!  Mainly used for debugging of AX.25
  4526.             protocol problems.
  4527.  
  4528.        TraceIP [ON/OFF]
  4529.             Enables/disables trace of TCP/IP problems. Again mainly for
  4530.             debugging purposes!
  4531.  
  4532.        TREtries number
  4533.             Network node Transport retries. Default is 3.
  4534.  
  4535.        TRUncate filename
  4536.             Adds CR/LF to files as needed to make lines no longer than 80
  4537.             characters so it can be edited with ED command.
  4538.  
  4539.        TS   HHMMSS
  4540.             TimeSet command - sets DOS time to given value (must be exactly
  4541.             6 digits)
  4542.  
  4543.        TTimeout number
  4544.             Network node Transport timeout in seconds (FRACK for the
  4545.             network). Default is 60 seconds.
  4546.  
  4547.        TXDelay [port#] number
  4548.             Keyup delay (usually in 10 mS increments) number given can be
  4549.             between 0 and 255 (its best to err on the high side). This
  4550.             number is sent to the TNC. For more information, check your TNC
  4551.             book.
  4552.  
  4553.        TXTail  [port#] number
  4554.             Keydown delay - how long to wait after sending a packet to unkey
  4555.             the transmitter. The number can be between 0 and 255. This
  4556.             command should be used with TNC-2 clone TNCs (any tnc that uses
  4557.             hardware switches to set baud rate going to radio) when on HF.
  4558.             Without this parameter the TNC keys up on the transmitter before
  4559.             the complete packet is sent.  Try a value of 20 as a starting
  4560.             point.
  4561.  
  4562.  
  4563.  
  4564.        MSYS 1.18                                                   Page 66
  4565.  
  4566.  
  4567.  
  4568.  
  4569.  
  4570.        TYpe filename
  4571.             Allows you to type a file.  Use spacebar to stop/start and a
  4572.             control Z or A to abort.
  4573.  
  4574.        Users filename
  4575.             Writes out all users info to formatted ASCII file
  4576.  
  4577.        VAlidmsgtype [arg]
  4578.             The argument is a list of letters that may follow S in send
  4579.             commands in the bbs.  Defaults are BTPW.
  4580.  
  4581.        VErifysysop [ON/OFF]
  4582.             If on then whenever any variation of the id call is used to
  4583.             connect to the BBS (except from the local keyboard) then 4
  4584.             characters from the REMOTE SYSOP phrase must be entered.)  NOTE:
  4585.             THIS MAY NEED TO BE SET TO PREVENT UNWANTED ACCESS BY LESS-THAN-
  4586.             HONEST (AB)USERS.  The REMOTE SYSOP phrase is in a file called
  4587.             PASSWORD.RMT in your FWD directory that is the same as the
  4588.             MSYS.RMT file on the other system.
  4589.  
  4590.        VIdeo     [COLOR/MONOCHROME]
  4591.             You can change the monitor you want to use while the system is
  4592.             running (using COLOR or MONOCHROME as a parameter).  I've got
  4593.             both connected to my systems here (at the same time) so it is
  4594.             meaningful to switch back and forth on rare occasions (like to
  4595.             see if it works).  You probably ought to specify the one you
  4596.             want to use in your MSYS.OPT file and not otherwise use this
  4597.             command.
  4598.  
  4599.        WAtch chan#
  4600.             This command allows you to see all that occurs  in both
  4601.             directions for the channel you specify.  Watching is turned off
  4602.             when the channel is closed or you use the WAtch command a second
  4603.             time  for that same channel.  The lines that go to the screen
  4604.             are not labeled in any way, they are just sent to the screen.
  4605.             If you WAtch more than one channel at a time it will work but
  4606.             you may wonder which line came from which channel.  Using watch
  4607.             may have some side effects like resetting the window being used
  4608.             by the process using the channel you have selected.  You should
  4609.             probably not "watch" a forwarding channel. That's a "feature" of
  4610.             this program and will not be corrected!
  4611.  
  4612.        WBackgrnd number
  4613.             This command requires two parameters to set back- ground color:
  4614.             Window# and Color#.  The color number should be between 0 and 7.
  4615.  
  4616.        WColors
  4617.             Gives list of color names and their numbers
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.        MSYS 1.18                                                   Page 67
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.        WForegrnd number
  4632.             This command requires two parameters to set fore- ground color:
  4633.             Window# and Color#.  The color number should be between 0 and
  4634.             15.
  4635.  
  4636.        WHO
  4637.             Displays current users and messages.
  4638.  
  4639.        Window
  4640.             Use of this command is a good way to see what numbers mean in
  4641.             the various window definition commands.
  4642.  
  4643.        WHY msg#
  4644.             This command will search for the words in wordfile or hold file
  4645.             in the given message#.  Useful when you do a LH and want to see
  4646.             why the message was held.
  4647.  
  4648.        WPAge number number
  4649.             This command requires two parameters to set page number: Window#
  4650.             and Page#.  The page number must currently be between 0 and 3.
  4651.             Basically this command defines what page a window will appear
  4652.             in. Example: WPA 5 3
  4653.             would assign window 5 to page 3 (the one you see when you press
  4654.             the F4 key). This example assignment, by the way, will not be
  4655.             particularly useful!
  4656.  
  4657.        WPEvery number
  4658.             Specifies the number of days between sending out WP information
  4659.             for users who haven't changed their  information.  Default is 60
  4660.             days.
  4661.  
  4662.        WQupdate number
  4663.             Worst quality network node destination node route to record.
  4664.             Default is one.
  4665.  
  4666.        WRecord [number]
  4667.             Window record sends all output to a disk file. The first time
  4668.             use the command for a given window it begins recording
  4669.             everything sent to that window in a file called window.dat where
  4670.             N is the window number.  The second time you use the command for
  4671.             the same window it turns off recording for that window.  Using
  4672.             the command with no operands displays the status of recording.
  4673.             NOTE: This function produces a lot of disk output quickly.  It
  4674.             can fill up your disk.  It also slows down the system a fair
  4675.             amount due to all the disk writes.  This command was added for
  4676.             debugging purposes and should not be used as a general purpose
  4677.             capture command.  You can determine the window numbers by using
  4678.             the W? command.
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.        MSYS 1.18                                                   Page 68
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.        WSize number number number number number
  4693.             Specifies coordinates for specified window This command requires
  4694.             5 parameters.  The first is the window# being defined.  The
  4695.             remaining parameters are two pairs of numbers giving the upper
  4696.             left and lower right corners of the window.  The pair is column
  4697.             number (1,80) then row number (1 to 25).  Overlapping windows
  4698.             may produce amusing results.  To specify window 3 as being the
  4699.             entire screen the following command may be used: WS 3 1 1 80 25
  4700.  
  4701.        W?
  4702.             Use of this command is the easiest way to find  out which window
  4703.             is which! It displays the window number of each window in the
  4704.             upper left hand corner of that window.
  4705.  
  4706.  
  4707.        XBatchsize [port] #
  4708.             Sets number of bytes of uncompressed data per batch for RLI
  4709.             compression on port.  The value defaults to 0, which means only
  4710.             one message will be forwarded per batch.
  4711.  
  4712.        XOption [port#] [on/OFF] If on, enables RLI compressed forwarding
  4713.                  on port
  4714.  
  4715.  
  4716.        Yapp [port#] [on/OFF]
  4717.             Enables use of Yapp (binary file transfer between users and the
  4718.             BBS) on selected ports.
  4719.  
  4720.        <Esc>
  4721.             Cancel partially typed command
  4722.  
  4723.  
  4724.  
  4725.  
  4726.  
  4727.  
  4728.  
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.        MSYS 1.18                                                   Page 69
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.        Function key usage:
  4755.  
  4756.        F1 through F4 select page to display (0 to 3 respectively)
  4757.  
  4758.        F6 causes the following characters to the next return to be treated
  4759.             as a command even if keyboard currently connected to some other
  4760.             process (such as local BBS, etc.).
  4761.  
  4762.        F8 key can be used to blank the screen.  Pressing any other key will
  4763.             unblank the screen.  A new SYSOP command is also added that
  4764.             allows you to specify the number of minutes after last keystroke
  4765.             to blank the screen automatically:
  4766.  
  4767.        Alt-F1 Alt-F2 Alt-F3 keys work like DOS F1 F2 and F3 commands to
  4768.             retrieve/edit last SYSOP command typed.
  4769.  
  4770.        Ctrl/F2  suspends  activity on the monitor  screen.   ^F2 restores
  4771.             normal operation.  This is probably as close as  being able to
  4772.             scroll the F2 screen that I will be implementing.
  4773.  
  4774.        Ctrl/F4 terminates MSYS as if QUIT command was used
  4775.  
  4776.        Ctrl/F5 is the same as the PROcesses command
  4777.  
  4778.        Ctrl/F6 assigns keyboard to command processor
  4779.  
  4780.                    MOST COMMANDS GIVE INFORMATION ON THEIR
  4781.                  USAGE IF YOU TYPE COMMAND NAME FOLLOWED BY A
  4782.                                 QUESTION MARK.
  4783.  
  4784.                                    Example: WS ?
  4785.  
  4786.                  MOST COMMANDS GIVE THE CURRENT VALUE SET IF
  4787.                        YOU TYPE JUST THE COMMAND NAME.
  4788.  
  4789.                                   Example: FRAck
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.        MSYS 1.18                                                   Page 70
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.                               MSYS BBS USER COMMANDS
  4816.  
  4817.  
  4818.  
  4819.        A - Abort                P - Path to station
  4820.        B - Bye                  PC - Call Sign Server
  4821.        C - Conference           R - Read message
  4822.        D - Download             S - Send Message
  4823.        G - Search file          T - Talk to SYSOP
  4824.        H - Help                 U - Current users
  4825.        I - Information          V - Version
  4826.        J - Calls heard          W - What files
  4827.        K - Kill message         X - Expert-Mode
  4828.        L - List Messages        Y - YAPP Command
  4829.        LC - List Catagories     ?x - Info about command
  4830.        M - Message of the day   * - Comment line
  4831.        N - Enter name/qth
  4832.  
  4833.        The A (abort) command to the BBS.  It can be used to abort output
  4834.        from most BBS commands, like Download, List and Read.
  4835.  
  4836.        The Bye command disconnects you from the BBS.  Use it when you are
  4837.        done!
  4838.  
  4839.        The C command enters the user into the Conference.  Following lines
  4840.        typed will be sent to all stations in the local conference.  Control-
  4841.        ZQ (^ZQ) or /EX may be used to exit the conference.  When a station
  4842.        enters or exits the conference, a message noting the event is sent to
  4843.        the stations in the conference.  Other Conference commands are:
  4844.                  ^ZH produces the help text
  4845.                  ^ZU Lists the current BBS users
  4846.                  ^ZA #  Asks the user on the given channel number to join
  4847.                  the conference
  4848.  
  4849.        The CC command allows sending a "Carbon Copy" of a given message to
  4850.        other stations.  Only the originator of the message, the destination
  4851.        station, or the SYSOP can do this for a given message.  Syntax is: CC
  4852.        msg# call1@BBS1; call2@bbs2 ...  The @bbs parts are optional if the
  4853.        calls are users of your system.  Example: cc 4725 k8eiw@wb8bii; no8m
  4854.        An alternate syntax for this command is: CC msg# <filename Where
  4855.        filename does not include a file type (.DIS is automatically
  4856.        appended).  This file contains tocalls (and optionally @BBS) of the
  4857.        stations that should get the copies.  There is one call per line of
  4858.        the file.  Example:
  4859.             CC 3195 <locals
  4860.             The file LOCALS.DIS could contain:
  4861.             k8eiw @ wb8bii
  4862.             NO8M
  4863.  
  4864.  
  4865.  
  4866.  
  4867.  
  4868.  
  4869.        MSYS 1.18                                                   Page 71
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.        The Download command is used to read a file stored on the system.
  4876.        The format of the command is D filename where filename is the name of
  4877.        the file to download.  To see what files are available for
  4878.        downloading, use W or WN command.  To get a file from a subdirectory
  4879.        type:
  4880.  
  4881.         d <directory_name>/<filename)>
  4882.  
  4883.        The G command (for grep, a Unix utility) allows you to search a
  4884.        downloadable file for a specified string of characters, printing all
  4885.        lines that contain the string of characters.  Case is ignored in the
  4886.        comparison.  No wild cards (like ? or *) are recognized.  When you
  4887.        use this command you will be asked for a file name and then a search
  4888.        string.  For file name enter the name that you would use if you were
  4889.        downloading the entire file.  If you do not give a file name,
  4890.        Database.0 will be assumed.  When the command is used, the user will
  4891.        be asked for the file name to search and then the search pattern.
  4892.  
  4893.        The default directory FILES\ will be prefixed to the file name the
  4894.        user gives UNLESS the DOS SET command has been used for filesdir.
  4895.        Thus downloadable files may be pattern searched, and in the directory
  4896.        that the sysop chooses to make available.
  4897.  
  4898.        The G command is not available when the BBS is in limited service
  4899.        mode.
  4900.  
  4901.        The GX command permits search on the directory specified by the DOS
  4902.        SET msys:grepdir (default is FILES).
  4903.  
  4904.          SEE ADVANCED USERS SECTION for details.
  4905.  
  4906.        The H command will give you a short description of the commands.  For
  4907.        more information about a particular command, type ?x where x is the
  4908.        letter of the command.
  4909.  
  4910.        The I command by itself gives hardware configuration of this system.
  4911.        (the information displayed comes from HELP\INFO.HLP)
  4912.             For example:
  4913.             This system runs on an IBM PC type computer and is written in C.
  4914.             It uses TNCs running in KISS mode which allows all the fancy 
  4915.             stuff it does.
  4916.                  Location is Port Huron, Michigan
  4917.                  TNCs KPC-4
  4918.                  PK-232
  4919.                  Frequency Radio Power Antenna
  4920.                  145.03 MOCOM 70 60 W Isopole at 80 ft
  4921.                  145.09 TR-7400A 30 W Isopole at 30 ft
  4922.                  If you have any questions please leave a message.
  4923.  
  4924.        ID gives a list of the ports and digipeaters/gateways available.
  4925.  
  4926.  
  4927.  
  4928.  
  4929.  
  4930.        MSYS 1.18                                                   Page 72
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.        JH command lists stations recently heard on the various ports and
  4937.        stations that recently connected.  Use the P command for path to
  4938.        station that have connected at some time.  For the following commands
  4939.        the sponsor's callsign is given in {curly brackets}.  This is
  4940.        normally NOT the call you would use.  This callsign is given to help
  4941.        identify some of the "mystery" callsigns used for nodes and
  4942.        digipeaters such as "MYDIGI".
  4943.  
  4944.        JBbscommand gives a list of BBS's that have been heard along with
  4945.        date and time they were heard and the path to them.
  4946.  
  4947.        JDigipeat command gives a list of the Digipeaters that have been
  4948.        heard along with the date and time they were heard and the path to
  4949.        them.
  4950.  
  4951.        JGateways command gives a list of the Gateways that have been heard
  4952.        along with the date and time they were heard and the path to them.
  4953.  
  4954.        JKanodes command gives a list of the KAnodes that have been heard
  4955.        along with the date and time they were heard and the path to them.
  4956.  
  4957.        JMsys command List other MSYS systems that have been heard.
  4958.  
  4959.        JNetrom command gives a list of the NET/ROM nodes that have been
  4960.        heard along with the date and time they were heard, the real callsign
  4961.        of the NODe and the path to them (most are direct).
  4962.  
  4963.        You can specify a port number as an argument to limit the display to
  4964.        just that port.  For example:
  4965.             JK 1 would display the KA Nodes heard on port 1 only.
  4966.  
  4967.        The K command is used to kill (delete) old messages from the
  4968.        system.  You can kill only those messages that are to or from your
  4969.        station.  The format of the command is K, a space, and then the
  4970.        number of the message to delete.  Multiple message numbers separated
  4971.        by a space may also be killed.
  4972.  
  4973.        Example: k 123 6789 1123.
  4974.  
  4975.        KM - To delete all messages TO you.
  4976.  
  4977.        KF - Kill messages that have been forwarded (sysop only).
  4978.  
  4979.        KT - Msg# to kill NTS traffic you are going to deliver.
  4980.  
  4981.        The following "K" Commands Are SYSOP only:
  4982.  
  4983.        K* -  Goes through ALL messages, allowing you to kill, keep or hold
  4984.        any of them.  You can also read a given message (it must be in the
  4985.        mail.bak directory).  When reading a message this way, use the space
  4986.        bar to pause the display.
  4987.  
  4988.  
  4989.  
  4990.  
  4991.        MSYS 1.18                                                   Page 73
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.        K@ - kills all messages with given @BBS. only compares the leftmost
  4998.             part of the @BBS field (the normally visible part of a
  4999.             hierarchical address) instead of any part which caused
  5000.             unexpected deletions.
  5001.             Example: K@ ARRL
  5002.  
  5003.        K> <call>  or K< <call> will kill all messages to or from a callsign
  5004.             or "group".
  5005.  
  5006.        L - The List command lists selected message headers. The following
  5007.             formats are available:
  5008.             L  - List messages since you last used the B command
  5009.             LB - List bulletins (all of them, use with care!)
  5010.             LC - List Catagories ("TO" fields)
  5011.             LM - List messages to or from you  (List Mine)
  5012.             LN - List messages with type of N  (List Not read or
  5013.             forwarded)
  5014.             LO - Lists msgs older then date given as YYMMDD Ex.:
  5015.             LO 910204
  5016.             LT - List NTS Traffic messages
  5017.             LL # - List the last # messages         Example: LL 10
  5018.             LU - Lists unread messages to you
  5019.             L< callsign - List messages from callsign    Example:
  5020.             L< WA8BXN
  5021.             L> callsign - List messages to callsign Example:
  5022.             L> WA8BXN
  5023.             L@ callsign - List messages being sent to BBS call     Example:
  5024.              L@ WA8BXN
  5025.             L # - List messages >= given number          Example: L 827
  5026.             L # # - List messages from # to #            Example: L 50 75
  5027.             L"string" - Lists messages with given string in title (case
  5028.             insensitive)
  5029.             L'string' - Lists messages with given string in title (case
  5030.             insensitive)                                 Examples:
  5031.             L'Pfb'
  5032.             L"ID's"
  5033.             l"Modem users"
  5034.  
  5035.        Note: When asked for msg#'s to read, always use the indicated number
  5036.        of digits.  Use leading zero's if needed to get the requested number
  5037.        of digits!  Example for a 5 digit message number:   00123
  5038.  
  5039.        The following are sysop only:
  5040.             LF - Messages that have been forwarded but not deleted
  5041.             LH - Messages marked as Held (invisible to all users)
  5042.             LY - Messages that have been read but not deleted
  5043.             L$ - Messages with type $
  5044.             L$$ - Messages with type $ (also gives their BIDs)
  5045.             L$ # # - Messages in range also giving their BIDs
  5046.             LL$ # - Last # messages, showing BIDs.
  5047.             L# - Bulletins that have been completely forwarded(type #)
  5048.             L? - Messages that MSYS doesn't know how to route
  5049.  
  5050.  
  5051.  
  5052.        MSYS 1.18                                                   Page 74
  5053.  
  5054.  
  5055.  
  5056.  
  5057.  
  5058.        The L< and L> commands will also take wildcards as arguments.
  5059.  
  5060.        Note: Messages that are Private are shown only to Sender, Addressee
  5061.        or SYSOP.
  5062.  
  5063.        If the listing from the L command exceeds the page limit you have set
  5064.        with the X command, it will permit you to enter the last 2,3, or 4
  5065.        numbers of the message numbers that you wish to read.  Upon
  5066.        completion of the displaying of the desired messages, it will
  5067.        continue with the listing of messages.
  5068.  
  5069.  
  5070.        The M command may be used to display the Message of the day.
  5071.             Normally this message (if not empty) is displayed when you
  5072.             connect unless you have selected Expert mode (?X for more info
  5073.             on Expert mode).  If you have selected Expert mode, using the M
  5074.             command is the only way to see any Message of the day.  If there
  5075.             is no message of the day, you will simply get the next command
  5076.             prompt.  The message of the day will advise you of new features
  5077.             and other important information.  Example:  M
  5078.  
  5079.        N command can be used to register your name or QTH.  You should enter
  5080.             both of these.  To enter your name type N your name.
  5081.             Example: N Mike
  5082.  
  5083.        To enter your QTH, use the command NQ your qth.
  5084.             Example: NQ Kirtland, OH
  5085.  
  5086.        To enter your ZIP or Postal Code, use NZ code.
  5087.             Example: NZ 44026
  5088.  
  5089.        To enter the primary BBS that you look for your mail on use NH
  5090.        callsign.
  5091.             Example: NH WA8BXN
  5092.  
  5093.        The P command can be used to find the path last used by a station to
  5094.             connect to this system.  The format is P callsign.
  5095.             Example: P W1AW
  5096.        The information given comes from the station's use of the N commands
  5097.        and information recorded by the system.  Try the P command with your
  5098.        own call to check the information the system has about you.
  5099.  
  5100.        PC <callsign>  Will return the callsign information from the callsign
  5101.           database (if enabled).
  5102.  
  5103.  
  5104.  
  5105.  
  5106.  
  5107.  
  5108.  
  5109.  
  5110.  
  5111.  
  5112.  
  5113.        MSYS 1.18                                                   Page 75
  5114.  
  5115.  
  5116.  
  5117.  
  5118.  
  5119.        The PF  (bbs_callsign) command can be used to find out if this system
  5120.           knows how to forward mail to a particular BBS (what you would
  5121.           enter as @bbs in the S command).  The port number and call of the
  5122.           BBS to which the message would be sent is displayed along with the
  5123.           VIA list used for the connect.  If NetRom or KA Nodes are used to
  5124.           connect to the BBS to which the message would be forwarded to the
  5125.           fact is noted but the details are not given.  If this system does
  5126.           not contain the requested BBS in its forward file you get a
  5127.           message that the callsign is unknown.  
  5128.                  Example:
  5129.        PF WA8BXN
  5130.  
  5131.        The R command is used to read active messages in the bbs.  The
  5132.             following are variations of the R command:
  5133.  
  5134.             R # # ... Reads the given message numbers Ex: R 12734 11521
  5135.             RM   Reads your messages (Read Mine)
  5136.             R catagory  Reads the messages in a given TO" field.   Example:
  5137.             R SALE
  5138.             R> callsign Reads msgs with given "TO" field
  5139.             R< callsign Reads msgs from given callsign
  5140.             R@ callsign Reads msgs with given @BBS                 Example:
  5141.             R@ ARRL
  5142.             RE #  Read Export  This causes the given message(s) to be
  5143.             displayed with a S command line, followed by title, message text
  5144.             and then /EX in place of the normal way messages are displayed.
  5145.             If this form of output is saved using the output to file command
  5146.             [< filename] you can easily export messages to an ASCII file.
  5147.             RH <msg#> Gives complete forwarding information including R:
  5148.             header lines.
  5149.             RP        Read Preview.  It does a normal read operation but
  5150.             does not mark the message as having been read so it will show up
  5151.             if you do a LU command.
  5152.             RN <msg#> This is like the R command but no headers are printed,
  5153.             just the message text.  Good for marginal connections when you
  5154.             otherwise know the message number you want to read.
  5155.             REM  Read Export Mine.  Reads all messages to you in export form
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.  
  5173.  
  5174.        MSYS 1.18                                                   Page 76
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.        The following R commands are SYSOP only:
  5182.  
  5183.             RS   Reads all mail for SYSOP.  Note that when you read mail for
  5184.             SYSOP (ALL CAPS) it gets changed to mail for Sysop so that it
  5185.             won't continue to show up as a new msg.
  5186.  
  5187.             RES  Read Export Sysop.  Reads all messages to SYSOP in export
  5188.             form)
  5189.             R*   It allows you to read all held messages.  After each is
  5190.             read you are prompted to enter H to continue to holding the
  5191.             message, K to kill, N to release as private, or $ to release as
  5192.             a bulletin.
  5193.             R+   Goes through all the held msgs using the hold file trying
  5194.             to identify why each was held and allowing you to continue to
  5195.             hold, kill, or release as private or bulletin each message.
  5196.             R-   This is an abbreviated form of the R+ command, and is
  5197.             useful on HF or slow network channels.
  5198.  
  5199.        Typically, after a screenfull of lines is displayed on your terminal,
  5200.        you will be asked:
  5201.  
  5202.        More? [Y]es, No or Continuous
  5203.  
  5204.        Just press return for next screenfull, N to quit reading this message
  5205.        or category), or C to display all the rest without pausing. The
  5206.        number of lines per screen is set by the X command.
  5207.  
  5208.  
  5209.        REPly
  5210.             The REPly command is used to generate a reply to a message
  5211.             without having to do a S command.  The advantage of using the
  5212.             REPly command is that it will usually pick up the correct @BBS
  5213.             (often with proper H route) from the R: lines in the message
  5214.             being replied to.  You can use either:
  5215.             REPly msg# (example: REP 1234) or
  5216.             REPly msg#.  (example: REP 1234.).
  5217.  
  5218.             In the first form you will have to supply the title.  In the
  5219.             second form, a title is automatically generated of the form RE:
  5220.             the-original-title Messages that passed through SMTP systems
  5221.             will probably not generate the correct reply address.
  5222.  
  5223.             The SR command can be substituted for the REPLy command, and
  5224.             will perform the same function.  If you put a period after the
  5225.             msg #, a title will automatically be made by preceeding the
  5226.             original title with RE:
  5227.  
  5228.  
  5229.  
  5230.  
  5231.  
  5232.  
  5233.  
  5234.  
  5235.        MSYS 1.18                                                   Page 77
  5236.  
  5237.  
  5238.  
  5239.  
  5240.  
  5241.        S command      Format: Sx tocall @bbs $BID#
  5242.             Where x is message type (P=private, B=bulletin, T=traffic)
  5243.             If the x is omitted, and the MAkePRivate is on, the message will
  5244.             automatically be made a type SP
  5245.             Tocall is DEStination callsign (without - number/SSID)
  5246.             @bbs is DEStination BBS (again without any - number) [OPTIONAL]
  5247.             ---> If @BBS part is omitted, if the station has entered a Home
  5248.             BBS (NH command) that BBS will be used.  Otherwise the to
  5249.             station callsign will also be used as the @BBS.
  5250.             $BID# is the Bulletin IDentification Number [Valid ONLY for type
  5251.             B - OPTIONAL - if omitted, MSYS will assign if needed.]
  5252.  
  5253.        Examples:
  5254.        SP call @ bbs.haddr SP K8EIW @ WB8BII             Send a pvt. msg
  5255.        ST zipcode @ NTSst  ST 44070 @ NTSOH              Send traffic msg
  5256.        SB catagory @ route SB NEED @ ALLOH               Send a bulletin
  5257.        SR msg#             SR 12723 or SR 12723.         Send reply.
  5258.  
  5259.             You will next be asked for a title for the message (except for
  5260.             the SR 12723. form).  After this you type the message, keeping
  5261.             all lines less than 80 characters.  When you are done with the
  5262.             message type ^Z or /EX on a new line.
  5263.  
  5264.        Never use SSID's in callsigns (ex: don't use WA8BXN-2, just use
  5265.        WA8BXN)
  5266.  
  5267.        Hierarchical addresses (haddr)  are of the form:
  5268.        state.country.continent.
  5269.        Other sub-areas may be used by BBS in a particular area, such as:
  5270.        #NEOH.OH.USA.NOAM.  Generally, the bbs will be aware of the full
  5271.        hierarchical address of a bbs (from the BBSLIST.DAT file).
  5272.  
  5273.        When sending personal messages to a distant bbs, it is a good idea to
  5274.        put the destination city and state in the title.
  5275.  
  5276.  
  5277.  
  5278.  
  5279.  
  5280.  
  5281.  
  5282.  
  5283.  
  5284.  
  5285.  
  5286.  
  5287.  
  5288.  
  5289.  
  5290.  
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.        MSYS 1.18                                                   Page 78
  5297.  
  5298.  
  5299.  
  5300.  
  5301.  
  5302.             If you type ^A in place of ^Z when you are done typing a
  5303.             message, the message will not be stored.
  5304.  
  5305.             Users who send messages to stations without giving any @BBS or
  5306.             giving unknown @BBS are warned of the fact.
  5307.  
  5308.             Use SB to send bulletins, ST to send traffic, etc.  All messages
  5309.             sent to a specific callsign will be treated as if you used SP
  5310.             (send private).  To make messages to a specific callsign
  5311.             readable by everyone use SB instead of just S! Or make it to a
  5312.             non-callsign (such as ALL).  If you are sending a bulletin that
  5313.             may also be entered on other BBS, use the form:
  5314.  
  5315.             SB <to> @<bbs> $<BID#>
  5316.  
  5317.             so that a proper BID# will be assigned.
  5318.  
  5319.             The SR <msg#> command functions identical to the REPLy <msg#>
  5320.             command.
  5321.  
  5322.             The ST Command will NOT add a BID to messages.
  5323.  
  5324.             Notes about the @BBS:
  5325.  
  5326.             Automatic generation of @BBS field for S command in BBS:  If the
  5327.             S command contains an @BBS entry it is left untouched.  If there
  5328.             is no @BBS as a parameter for the S command, the following
  5329.             happens.  If the to station is found in the user file then the
  5330.             home bbs of that station is substituted for the given @BBS.  If
  5331.             the to station is not a known user then the to station callsign
  5332.             is placed in the @BBS field.
  5333.  
  5334.             Any messages entered into the system with no @BBS that don't get
  5335.             a @BBS from the user file will have ==== for the @BBS.  Only
  5336.             messages with second type character of N will cause the user
  5337.             file to be searched for @BBS.  Thus bulletins will never get
  5338.             their to call sign (typically ALL) looked up in the user file.
  5339.  
  5340.             In the bbs, if a S command has an SSID in the @BBS filed it is
  5341.             removed in the leftmost part of the hierarchical address.  Thus
  5342.             S W1XYZ @ K1XXX-5 is taken as S W1XYZ @ K1XXX.
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.        MSYS 1.18                                                   Page 79
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.        T    The T command (talk to sysop).  When a bbs user types T you will
  5364.             get the connect music and then have 60 seconds to type something
  5365.             or they will be put back to the bbs.  If you do type to them
  5366.             then when you are done with your conversation and do ^Cd then
  5367.             they will go back to the bbs.  The keyboard call can still be
  5368.             used for incoming connects; note that it is accessible to all
  5369.             stations, even on closed bbs ports.  Outgoing connects are the
  5370.             same as they have always been.  When an incoming keyboard
  5371.             connect occurs, you will automatically be taken to the F1 screen
  5372.             If you wish to prevent users from ringing your bell, set MCON 0.
  5373.  
  5374.        U    The U command gives the current users of the bbs plus the number
  5375.             of active messages and users and what they are doing.
  5376.  
  5377.        UPload
  5378.             The UPload command To use it, the user must be authorized (see
  5379.             user flags ).  To do an upload, the user types UP on the BBS.
  5380.             MSYS will then ask for the file name to be uploaded.  If no file
  5381.             name is entered, or the file exists (in the FILES directory) the
  5382.             upload is terminated.  If the filename is accepted, the user
  5383.             then sends the ASCII file, ending with a line that contains only
  5384.             ^Z.  Once the transfer is started, it may be aborted by sending
  5385.             a line with ^A.
  5386.  
  5387.        Version
  5388.             The V command gives the version of this software and date and
  5389.             time MSYS was started.
  5390.  
  5391.        W    The W command lists the available files for downloading.
  5392.             Examples:
  5393.        W    Lists all files in C:\MSYS\FILES
  5394.        W (Dir1)  Lists all files in the (Dir1) subdirectory of 
  5395.                  C:\MSYS\FILES\(Dir1).
  5396.  
  5397.             The directory list provided includes the dates & sizes of the
  5398.             files.
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.        MSYS 1.18                                                   Page 80
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.        X    Command can be used to set or reset Expert status and also to
  5425.             set the number of lines sent before pausing during an R command.
  5426.             If no argument is given, X simply toggles and displays the new
  5427.             Expert status.  When Expert status is set, the initial connect
  5428.             messages are replaced by a compatibility identifier line ([MSYS-
  5429.             1.14-BFH$]) and the command prompt is simply >.   If a number is
  5430.             given after X, this is the number of lines to display for a R
  5431.             command before asking More?  To continue displaying the current
  5432.             message when More? is sent, press return.  To abort the message,
  5433.             type N and then return.  This facility has been added to prevent
  5434.             a long message from scrolling off your screen faster than you
  5435.             can read it.  Experiment with different values until you find
  5436.             one that pleases you.  To not use this facility, set the number
  5437.             of lines to zero.  Examples: X 20 (pause after every 20 lines) X
  5438.             0 (don't pause ever).  When you get More? in R cmd output (as a
  5439.             result of using X cmd to set lines between pauses), you can type
  5440.             C for continue without any more stops.
  5441.  
  5442.        XC
  5443.             Toggles the automatic display of msg catagories when you connect
  5444.             to the bbs and are using non-expert mode.  Default for new user
  5445.             is ON
  5446.  
  5447.        XF and XS Commands
  5448.             XF sets "fast" mode, XS sets "slow" mode.  Fast mode means that
  5449.             multiple lines are placed in packets for some commands (like D,
  5450.             R and L).  Slow mode means one line per packet as it has been
  5451.             (the default).  XF is faster for users with good paths.  XS is
  5452.             better for users with poor paths (or busy channels!).
  5453.  
  5454.        XR
  5455.             Toggles the automatic asking if you want to reply to a msg after
  5456.             you read it. Can be useful if you get a lot of personal mail.
  5457.             Default for new user is OFF.
  5458.  
  5459.        YD pathname filename
  5460.             YAPP download of the given file.  Users must start their YAPP
  5461.             function within 30 seconds of issuing the command.
  5462.  
  5463.        YU pathname filename
  5464.             YAPP upload of the given file.  Users can not delete or replace
  5465.             existing files.  Users must be enabled with user bit $800 to be
  5466.             able to upload files.
  5467.  
  5468.        YW   List files in the default YAPP directory.  (See section on DOS
  5469.             SET for further details on defaults.)
  5470.  
  5471.        YW xxx    List the contents of the xxx directory under the YAPP
  5472.             directory.
  5473.  
  5474.  
  5475.  
  5476.  
  5477.  
  5478.  
  5479.        MSYS 1.18                                                   Page 81
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.        *    Putting * at the beginning of a line makes it a comment.  It
  5486.             also suppresses the next command prompt (but the system will be
  5487.             waiting for another command).  * is useful to answer the SYSOP
  5488.             if you get a: MESSAGE FROM SYSOP
  5489.  
  5490.        < filename (sysop only)
  5491.             Causes the commands found in the given file to be processed as
  5492.             if they were typed from the keyboard.  This may be used as a
  5493.             message import function if messages are placed in a file.  A
  5494.             sample is:
  5495.                  SB ALL @ ARRL < W1AW $XYZ27
  5496.                  Sample title
  5497.                  This is the text of the message.  It is short.
  5498.                  /EX
  5499.             You can of course have many messages in the file.  When end of
  5500.             file is found, input is taken again from the keyboard.
  5501.  
  5502.        > filename and >> filename
  5503.             Both of these commands cause output normally sent to the screen
  5504.             to be also saved in the indicated file.  Using just one > causes
  5505.             a new file to be created (replacing any existing file by that
  5506.             name).  Use of two > before the filename causes output to be
  5507.             appended to the end of the filename given (if it exists).  To
  5508.             terminate writing to the file, use either of these commands
  5509.             without a file name.  While output is being saved to a file,
  5510.             there will be NO PROMPT FOR NEXT COMMAND.
  5511.  
  5512.        /<cmd>    To be used for sysop commands while in the BBS (see remote
  5513.             sysop) or:
  5514.        \<cmd>    To be used for sysop commands while in the BBS (see remote
  5515.             sysop)  Either symbol works!
  5516.  
  5517.  
  5518.  
  5519.  
  5520.  
  5521.  
  5522.  
  5523.  
  5524.  
  5525.  
  5526.  
  5527.  
  5528.  
  5529.  
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.  
  5540.        MSYS 1.18                                                   Page 82
  5541.  
  5542.  
  5543.  
  5544.  
  5545.  
  5546.                                   REQxxx SERVERS
  5547.  
  5548.  
  5549.        A set of REQxxx servers are available in the BBS they are: REQDIR,
  5550.        REQFIL and REQQTH.  Messages sent to your system to REQanything will
  5551.        be processed.  If a server is not available for the requested
  5552.        function, a reply message will be generated stating that the server
  5553.        is not available.  The servers named above are enabled by new
  5554.        commands of the same names.  That is, using REQDIR ON will enable the
  5555.        REQDIR server, etc.  Enabling the REQQTH server also requires that a
  5556.        file name containing the Buckmaster CD ROM ASCII callbook file
  5557.        (normally S:HAM0\HAMCALL.129) be specified with the CAllfile command.
  5558.  
  5559.        The REQDIR server responds with a message to the requester containing
  5560.        either the FILES directory listing or specified FILES directory
  5561.        subdirectories given in the message title.  An @BBS to which the
  5562.        message is to be returned may optionally be given in the title if the
  5563.        reply is to go to a bbs other than the one at which the original
  5564.        message was entered.  Examples:
  5565.  
  5566.        SP REQDIR @WA8BXN
  5567.           (blank title)
  5568.        ^Z
  5569.        would return a listing of the FILES directory to the bbs used to
  5570.        originate this message.
  5571.  
  5572.        SP REQDIR @ WA8BXN @NT8V  (title)
  5573.        ^Z
  5574.        would return a listing of the FILES directory to the sending
  5575.        station @ NT8V.
  5576.  
  5577.        Subdirectories may be given in the title, proceeded by a slash and
  5578.        separated with blanks.  The optional @BBS may also be specified.
  5579.        Example:
  5580.  
  5581.        SP REQDIR @ WA8BXN
  5582.        /MODS /PGMS/BASIC
  5583.        ^Z
  5584.        The file REQDIR.HLP included on the distribution disk should be
  5585.        placed in the HELP directory.  The file REQFIL.HLP should be placed
  5586.        in the FILES directory.
  5587.  
  5588.        The REQFIL server responds by sending the requested file.  The file
  5589.        name is specified in the title of the message.  Subdirectory names
  5590.        may be given if needed (don't include the leading /).  An @BBS can be
  5591.        specified in the title as described for REQDIR above.
  5592.        Example:
  5593.  
  5594.        SP REQFIL @ WA8BXN
  5595.        mods/kam.1 mods/kam.2
  5596.        ^Z
  5597.  
  5598.  
  5599.  
  5600.  
  5601.        MSYS 1.18                                                   Page 83
  5602.  
  5603.  
  5604.  
  5605.  
  5606.  
  5607.        The REQQTH server responds with callbook information for calls given
  5608.        in the title.  Currently only US hams are in the callbook file.
  5609.        Calls must be separated by blanks.  An @BBS may be specified as
  5610.        described above.
  5611.        Example:
  5612.  
  5613.        SP REQQTH @ WA8BXN
  5614.        nt8v no8m K8EIW
  5615.        ^Z
  5616.  
  5617.  
  5618.  
  5619.  
  5620.  
  5621.  
  5622.  
  5623.  
  5624.  
  5625.  
  5626.  
  5627.  
  5628.  
  5629.  
  5630.  
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.  
  5637.  
  5638.  
  5639.  
  5640.  
  5641.  
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.        MSYS 1.18                                                   Page 84
  5663.  
  5664.  
  5665.  
  5666.  
  5667.  
  5668.                                   CALLSIGN SERVER
  5669.  
  5670.        The callbook server has split out of MSYS.  There are three servers
  5671.        available, one for the Buckmaster CD ROM, one for the RT Systems SAM
  5672.        database, and one for the j-com disk files.  Note that the CAllfile
  5673.        command has been removed from MSYS.  In its place you specify the
  5674.        name of the file (or directory in case of j-com files) to be used
  5675.        when you start the appropriate call server TSR.
  5676.  
  5677.        To use either the Buckmaster CD ROM callsign files, or those
  5678.        available from j-com, and SAM (c) RT Systems,  you must load the
  5679.        appropriate TSR program before starting MSYS.  Once this is done,
  5680.        accessing the call server is the same as it has been in the past
  5681.        (using either the PC command in the BBS or sending a message to
  5682.        REQQTH @ the bbs call).
  5683.  
  5684.                       The TSR for the CD ROM files is CALLSRV1.  It
  5685.                       optionally takes one pararmeter, the name of the
  5686.                       callsign file.  If none is given, the default is
  5687.                       S:\HAM0\HAMCALL.129.
  5688.  
  5689.                       The TSR for the j-com files is CALLSRV2.  It
  5690.                       optionally takes one parameter, the name of the
  5691.                       directory in which you installed the several j-
  5692.                       com files.  If none is given, the default is
  5693.                       F:HAMBASE.
  5694.  
  5695.                       The TSR for the SAM (c) files is CALLSRV3.  It
  5696.                       optionally takes one parameter, the name of the
  5697.                       directory in which you installed the several SAM
  5698.                       (c) files.  If none is given, the default is
  5699.                       F:HAMBASE.
  5700.  
  5701.  
  5702.          THINGS NEEDED TO MAKE THE CD-ROM DATA BASE CALLSIGN SERVERS WORK:
  5703.  
  5704.  
  5705.        Put the following in your CONFIG.SYS and reboot system.
  5706.  
  5707.             LASTDRIVE=W
  5708.             DEVICE=SONY_CDU.SYS /D:MSCD210 /U:1 /B:340 /M:P /V /L:S /Q:*
  5709.             /T:*
  5710.  
  5711.  
  5712.        Run the following before MSYS (probably put these statements in
  5713.        AUTOEXEC.BAT):
  5714.  
  5715.             MSCDEX /D:MSCD210 /M:4 /L:S /V
  5716.             MSCDINFO
  5717.             CALLSRV1 S:\HAMO\HAMCALL.129
  5718.  
  5719.        Put the following in  MSYS.DO:
  5720.  
  5721.  
  5722.  
  5723.        MSYS 1.18                                                   Page 85
  5724.  
  5725.  
  5726.  
  5727.  
  5728.  
  5729.             REQQTH ON
  5730.  
  5731.        Notes: You may have to make changes in the above statements if you
  5732.        have different device drivers for your CD ROM drive or set up the
  5733.        hardware options differently.  Running without interrupts works
  5734.        pretty well on the CD ROM drive and if you are like me you don't have
  5735.        any interrupts to give to the drive anyway.  If you don't want to
  5736.        respond to REQQTH queries but only enable the PC command on the BBS,
  5737.        set REQQTH OFF.
  5738.  
  5739.        For all the servers, the title must be less than 39 characters.
  5740.  
  5741.          THINGS NEEDED TO MAKE THE SAM (c) DATA BASE CALLSIGN SERVER WORK:
  5742.  
  5743.        Put the following in your AUTOEXEC.BAT file.
  5744.  
  5745.                  E:\sam\api\samapi  E:\sam     This installs the SAM
  5746.                       (c)                      API interface.
  5747.                  C:\msys\callsrv3.exe E:\sam   This installs the MSYS
  5748.                                                interface to SAM (c)
  5749.  
  5750.        Of course, this presupposes that you have already installed the SAM
  5751.        (c) data base on your E: drive.
  5752.  
  5753.        Put the following in  MSYS.DO:
  5754.  
  5755.             REQQTH ON
  5756.             PC ON
  5757.  
  5758.        MSYS now supports the SAM optional County data base as well.
  5759.  
  5760.  
  5761.  
  5762.  
  5763.  
  5764.  
  5765.  
  5766.  
  5767.  
  5768.  
  5769.  
  5770.  
  5771.  
  5772.  
  5773.  
  5774.  
  5775.  
  5776.  
  5777.  
  5778.  
  5779.  
  5780.  
  5781.  
  5782.  
  5783.  
  5784.        MSYS 1.18                                                   Page 86
  5785.  
  5786.  
  5787.  
  5788.  
  5789.  
  5790.                                    MODEM SUPPORT
  5791.  
  5792.        MSYS will support one or more modem ports.  The modems must be
  5793.        capable of supporting true carrier detect (CD) operation.  Both the
  5794.        CTS and the DTR line must be connected!
  5795.  
  5796.                           MSYS modem forwarding protocol
  5797.  
  5798.        When MSYS attempts to forward to another BBS, the following protocol
  5799.        is used for the initial logon. When MSYS sees the other system send
  5800.        "Call:" or "Callsign :" it will respond with two lines. The first is
  5801.        "echo off" and the second is the callsign indicated in the forward
  5802.        file. Next, when it sees "Password:" or "Password :" it responds with
  5803.        a line that is the password from the forward file. It then proceeds
  5804.        using the normal packet protocol lines.
  5805.  
  5806.                               Incoming Call Protocol
  5807.  
  5808.        When carrier is detected from the modem, MSYS sends the line:
  5809.  
  5810.        MSYS Modem Interface (c) Copyright 1994 Hub Computers Inc.
  5811.  
  5812.        It then attempts to open MSYSMOD.MSG. If the file is found, its
  5813.        contents are sent to the modem. Next MSYS prompts with "Call:". At
  5814.        this point a human operator would enter their callsign value. An MSYS
  5815.        connecting for purposes of forwarding would reply with "echo off"
  5816.        which disables echoing by the called MSYS system and then the
  5817.        callsign value would be send on a second line.  MSYS next prompts
  5818.        with "Password:" and expects the password to be entered that
  5819.        corresponds to the previously given call sign.  These two words are
  5820.        then used to scan the MSYSPASS.MOD file to find a match.  If a match
  5821.        is found, the third word on the line in the MSYSPASS.MOD file is used
  5822.        as the apparent callsign with which the user will appear to have
  5823.        connected to the system.
  5824.  
  5825.        Here is an example of a normal user connecting into MSYS via modem:
  5826.  
  5827.        MSYS                     User
  5828.        -----                    --------
  5829.        MSYS Modem Interface ...
  5830.        [contents of MSYSMOD.MSG]
  5831.        Call:
  5832.                                 NO8M
  5833.        Password:
  5834.                                 camping
  5835.        [from this point on it looks just like a packet connection was made]
  5836.  
  5837.  
  5838.  
  5839.  
  5840.  
  5841.  
  5842.  
  5843.  
  5844.  
  5845.        MSYS 1.18                                                   Page 87
  5846.  
  5847.  
  5848.  
  5849.  
  5850.  
  5851.        Here is an example of a MSYS system forwarding into another MSYS
  5852.        system via modem:
  5853.  
  5854.        MSYS                     Calling MSYS system
  5855.        -----                    -------------------
  5856.        MSYS Modem Interface ...[contents of MSYSMOD.MSG]
  5857.        Call:
  5858.                                 echo off
  5859.                                 WA8BXN
  5860.        Password:
  5861.                                 BINGO
  5862.        [normal packet protocol follows]
  5863.  
  5864.  
  5865.        Use ONLY FBBC 0 and XO OFF on modem ports. Very Important!!!
  5866.  
  5867.        The use of FBB style forwarding and/or compression on the modem port
  5868.        will usually result in buffer overflows, and cause serious
  5869.        consequences to the continued high quality performance of the system.
  5870.  
  5871.        Note: To accommodate exchanges with FBB systems, use of control
  5872.        characters in the call and/or password should not be needed.  The
  5873.        callsign must be prefixed with a period to turn off echoing from the
  5874.        FBB system. Here is an example MSYSFWD.DEF file entry
  5875.  
  5876.             F2 K8EIW ATDP5551212 .WA8BXN MSYS
  5877.  
  5878.        The F2 could be R2 or P2 to ask for reverse forwarding or to always
  5879.        poll respectively. The 2 can be replaced by whatever port number your
  5880.        modem is connected to.
  5881.  
  5882.        K8EIW is the call of the bbs we are forwarding to.
  5883.  
  5884.        ATDP5551212 is the telephone number to call. The P could be replaced
  5885.        by T if tone instead of pulse dialing is desired.
  5886.  
  5887.        .WA8BXN specifies the "callsign" value to be give. The period says to
  5888.        FBB systems to turn off echoing. The actual callsign value used by
  5889.        FBB is just the WA8BXN part.
  5890.  
  5891.        MSYS is the "password" value that will be sent to the FBB system.
  5892.  
  5893.        This example is for forwarding to FBB systems. When forwarding to a
  5894.        MSYS system the only difference is that the period is NOT used in the
  5895.        "callsign" field.
  5896.  
  5897.  
  5898.  
  5899.  
  5900.  
  5901.  
  5902.  
  5903.  
  5904.  
  5905.  
  5906.        MSYS 1.18                                                   Page 88
  5907.  
  5908.  
  5909.  
  5910.  
  5911.  
  5912.  
  5913.                                   MSYS.OPT FILES
  5914.  
  5915.        The name of the port MUST be (in capitals) "MODEM"  Radiospeed must
  5916.        be set to 1200.  Port speed must be set to the speed of the modem for
  5917.        a 300 to 4800 baud modem.  For modems that can lock the port speed it
  5918.        should be set to at least 19.2k for a 9.6 or 14.4k modem.
  5919.  
  5920.             Here is an example:
  5921.  
  5922.        port 5 at $260 int 5 speed 19200 name MODEM radiospeed 1200 tnctype 2
  5923.  
  5924.  
  5925.                                       MSYS.DO
  5926.        The CTS option MUST be turned on in the MSYS.DO file.  The following
  5927.        shows the proper command for turning CTS on for port 5:
  5928.  
  5929.             CTS 5 ON
  5930.  
  5931.        The CTS line must be connected in the EIA cable from MSYS to the
  5932.        modem!
  5933.  
  5934.  
  5935.  
  5936.  
  5937.  
  5938.  
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.  
  5948.  
  5949.  
  5950.  
  5951.  
  5952.  
  5953.  
  5954.  
  5955.  
  5956.  
  5957.  
  5958.  
  5959.  
  5960.  
  5961.  
  5962.  
  5963.  
  5964.  
  5965.  
  5966.  
  5967.        MSYS 1.18                                                   Page 89
  5968.  
  5969.  
  5970.  
  5971.  
  5972.  
  5973.  
  5974.                                   MSYSTNC.x FILES
  5975.  
  5976.        There are a number of ways to set up the modem.  Here is a file for a
  5977.        Zoom 2400 baud modem:
  5978.             atz ---------- reset the modem to the power on defaults
  5979.             atq1 --------- don't send responses
  5980.             atm1 --------- speaker will be active until connect
  5981.             ats0=1 ------- answer on one ring
  5982.        The only problem that might show up with these files is that the
  5983.        "ats0=1" *MUST* be last in all the files.  If it is another location
  5984.        and someone is calling in at the time of the initialization, the
  5985.        modem will answer and then ignore all the commands that follow and
  5986.        come up with an improper initialization.
  5987.  
  5988.        One 2400 baud modem was found with a unique need.  Register 27 on a
  5989.        small plug-in was found to control the V22.bis routine.  If 27 was
  5990.        set to one (the default), then the modem would *NOT* initiate a
  5991.        V22.bis error correcting connect.  The factory default was that 27
  5992.        was set to never make an error correcting connect!  The line
  5993.        "ats27=0" cured the problem.  AND ... it was found on a very generic
  5994.        2400 baud modem that this same register, which was not mentioned in
  5995.        the documentation, worked the same way.  Check for register 27 on
  5996.        your 2400 baud modem!
  5997.  
  5998.        Here is the MSYS.OPT string used with a V32.bis Zoom modem which is
  5999.        able to connect from 300 to 14.4k (with automatic fallback):
  6000.        port 5 at $260 int 5 speed 19200 name MODEM radiospeed 1200 tnctype 2
  6001.  
  6002.        Here is the MSYSTNC.2 file that then sets it up:
  6003.  
  6004.             atz ........ reset
  6005.             at&f ....... load factory defaults
  6006.             atl0 ....... speaker volume low
  6007.             at&c1 ...... DCD follows carrier
  6008.             at&d2 ...... DTR signal setting
  6009.             atq1 ....... no responses
  6010.             atm1 ....... speaker on until carrier
  6011.             ats0=1 ..... answer in one ring
  6012.  
  6013.        This may or may not work with your modem.  A book and a whole bushel
  6014.        basket of experimentation may be necessary.  Without the book for
  6015.        your modem, your work will be cut out for you.
  6016.  
  6017.  
  6018.  
  6019.  
  6020.  
  6021.  
  6022.  
  6023.  
  6024.  
  6025.  
  6026.  
  6027.  
  6028.        MSYS 1.18                                                   Page 90
  6029.  
  6030.  
  6031.  
  6032.  
  6033.  
  6034.        One of the HAYES commands is AT&V.  This command will permit you to
  6035.        see the setup for the different registers in your modem.  The
  6036.        following is the display from a working Hayes Ultra 96 modem:
  6037.  
  6038.        ACTIVE PROFILE:
  6039.        B16 B1 B41 B60 E0 L1 M1 N1 Q1 T V1 W0 X4 Y0 &C1 &D2 &G0 &J0 &K3 &Q5
  6040.        &R0 &S2 &T4
  6041.        &U0 &X0 &Y0
  6042.        S00:001 S01:000 S02:043 S03:013 S04:010 S05:008 S06:002 S07:099
  6043.        S08:002 S09:006
  6044.        S10:014 S11:095 S12:050 S18:000 S25:005 S26:001 S36:007 S37:009
  6045.        S38:020 S44:003
  6046.        S46:002 S48:007 S49:008 S50:250 S97:030
  6047.  
  6048.  
  6049.        It has been reported to us that the following string works well with
  6050.        the US Robotics Sportster modem:
  6051.  
  6052.        AT&F&B1&H1&R2Q1M1S19=2X4S0=1
  6053.  
  6054.        The detail the individual commands is as follows:
  6055.  
  6056.        AT&F      Load factory (rom) settings into RAM
  6057.        AT&B1     Fixed serial port speed
  6058.        AT&H1     Hardware Clear to Send
  6059.        AT&R2     Received data hardware (RTS) flow control
  6060.        ATQ1      Supressed result codes
  6061.        ATS19=5   Inactivity timer set to 5 minutes
  6062.        ATX4      Dial tone detect, busy/no answer detect, etc
  6063.        ATS0=1    Answer on one ring
  6064.  
  6065.        DIP switch positions 1-7 off, and 8 on.
  6066.  
  6067.        It should be noted that some of the above commands do not exactly
  6068.        follow the Hayes Command set.
  6069.  
  6070.        There does not seem to be a problem initializing most modems with one
  6071.        long string as opposed to individual "AT" commands.
  6072.  
  6073.  
  6074.        Use at your own risk!  READ YOUR MODEM MANUAL!
  6075.  
  6076.  
  6077.  
  6078.  
  6079.  
  6080.  
  6081.  
  6082.  
  6083.  
  6084.  
  6085.  
  6086.  
  6087.  
  6088.  
  6089.        MSYS 1.18                                                   Page 91
  6090.  
  6091.  
  6092.  
  6093.  
  6094.  
  6095.                          MODEM USAGE AT 4.8, 9.6 AND 14.4k
  6096.  
  6097.        Hardware flow control between a modem using 9.6k or above is
  6098.        critical.  MSYS now hosts full CTS support.  This means that the
  6099.        modem's port speed can be set to a speed higher than the maximum
  6100.        connect speed.  When a connect is achieved, the speed between the
  6101.        modem and the computer remains at that higher speed no matter what
  6102.        the speed of the modem to the remote person connected.  If a person
  6103.        checks in with an old 300 baud modem, the speed between the computer
  6104.        and the modem remains at what it was sent as.  The modem will accept
  6105.        data until its buffer is full.  It will then signal the computer, via
  6106.        CTS control, that it is full and will await the buffer emptying
  6107.        before it tells the computer to send more data  A full RS-232 cable
  6108.        is necessary.  The three wire cables that work in some TNCs will not
  6109.        work here.
  6110.  
  6111.  
  6112.                                    NETNode USAGE
  6113.  
  6114.        Access to a network node from the modem is possible.  It is
  6115.        accomplished by adding the capitalized string "NETNODE" to the
  6116.        appropriate line in the MSYSPASS.MOD.  USE THIS OPTION WITH CAUTION!
  6117.        An example follows:
  6118.  
  6119.        wombat poobear WA8BXN NETNODE
  6120.  
  6121.        A user designated with the NETNODE parameter will first be put into
  6122.        the MSYS NETNODE and will have FULL capability to access the packet
  6123.        network.  For such a user to access the BBS, he would give the normal
  6124.        BBS command.
  6125.  
  6126.  
  6127.  
  6128.  
  6129.  
  6130.  
  6131.  
  6132.  
  6133.  
  6134.  
  6135.  
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.  
  6143.  
  6144.  
  6145.  
  6146.  
  6147.  
  6148.  
  6149.  
  6150.        MSYS 1.18                                                   Page 92
  6151.  
  6152.  
  6153.  
  6154.  
  6155.  
  6156.                                     FORWARDING
  6157.  
  6158.        This is the area of MSYS that requires the most study to properly
  6159.        establish.
  6160.  
  6161.        MSYS can forward in any of several ways:
  6162.  
  6163.        1. Standard AX.25 Non-compressed
  6164.        2. FBB non-compressed style
  6165.        3. FBB compressed style
  6166.        4. RLI compressed style
  6167.        5. SMTP - non-compressed
  6168.        6. Via Modem - NON-COMPRESSED
  6169.        7. Via Attended HF GTOR or PACTOR as well as AX.25 PACKET
  6170.        8. To (or from) a file
  6171.  
  6172.        MSYS can forward based on several parameters:
  6173.  
  6174.        1. On hierarchical address of a BBS
  6175.        2. On a unique "flood" route
  6176.        3. On a limited basis to a component of a hierarchical address used
  6177.           as a bulletin distribution area
  6178.        4. On a limited basis on the "TO" field as well as the "@BBS" field
  6179.        5. On ZIP code for NTS messages
  6180.  
  6181.        MSYS can forward at a specific time, or on timed intervals.
  6182.  
  6183.  
  6184.                                     FILE SETUP
  6185.  
  6186.        There are several files that must be set up for forwarding to happen.
  6187.  
  6188.        The first file that needs to be set up is the MSYSFWD.DEF.  This file
  6189.        is the script that MSYS uses to establish the connection to the
  6190.        distant bbs.  It is also the file that is merged with the specific
  6191.        lists of catagories to be forwarded, found in the <bbs_call>.FWD or
  6192.        <bbs_call>.REV files.
  6193.  
  6194.        Next, before any bulletins can be forwarded, a file called
  6195.        MSYSBBSB.DAT must be created.  That file consists of a maximum of 32
  6196.        lines (0-31) starting with a number on each line, followed by the
  6197.        callsign of the bbs that you will forward bulletins to.  Please refer
  6198.        to the example in the distribution.
  6199.  
  6200.  
  6201.  
  6202.  
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208.  
  6209.  
  6210.  
  6211.        MSYS 1.18                                                   Page 93
  6212.  
  6213.  
  6214.  
  6215.  
  6216.  
  6217.                              FORWARD FILE DESCRIPTION
  6218.  
  6219.  
  6220.        NOTE: TO FORWARD BULLETINS YOU MUST SET UP MSYSBBS.DAT!
  6221.  
  6222.        The MSYS forward file (MSYSFWD.DEF) is an ASCII file that can be
  6223.        prepared with any program editor.  The file consists of groups of
  6224.        lines separated by a line beginning with at least 3 dashes.  Each
  6225.        group of lines specifies what should be sent to a given BBS along
  6226.        with other information.
  6227.  
  6228.        The first line has the following format:
  6229.  
  6230.        Position       Content
  6231.        --------        -------
  6232.           1           F    (The letter) If you substitute R for F
  6233.                            (F0 becomes R0 WA8BXN) then it enables reverse
  6234.                            forwarding request.  P0 Forces a reverse
  6235.                            forward poll - EXCEPT IN FBBC MODE!
  6236.           2           0-6  The port number to use (a single digit)
  6237.           3           A blank
  6238.           4to N       Callsign of BBS (with SSID) optional:
  6239.           N+1         A blank
  6240.           N+2 to ?    Via list of digipeaters
  6241.  
  6242.        Examples:
  6243.             F0 W1XX V W2XX,W1XX-1
  6244.             R2 WA0XYZ-2
  6245.  
  6246.        When no nodes are being used, this first line is used as if it were a
  6247.        connect command to the desired system .  When a NODe is used, the Via
  6248.        digipeater list will have no effect.
  6249.  
  6250.        If a NODe (KA NODe or NET/ROM) is to be used, the next set of lines
  6251.        are a script of how to use the NODe(s).  This script may be up to 25
  6252.        lines long.  Its format will be described below.
  6253.  
  6254.  
  6255.  
  6256.  
  6257.  
  6258.  
  6259.  
  6260.  
  6261.  
  6262.  
  6263.  
  6264.  
  6265.  
  6266.  
  6267.  
  6268.  
  6269.  
  6270.  
  6271.  
  6272.        MSYS 1.18                                                   Page 94
  6273.  
  6274.  
  6275.  
  6276.  
  6277.  
  6278.        Next comes a list of callsigns of BBS systems that should be
  6279.        forwarded  to the system given on the first line (the one beginning
  6280.        with F).  There is one call per line.  No SSID should be given.  The
  6281.        callsign of the system given on the first line should normally be
  6282.        given in this list.  Example forward file that doesn't use any nodes:
  6283.  
  6284.        F0 W1XX
  6285.        W1XX
  6286.        W2ABC
  6287.        W2XXX
  6288.        ----------
  6289.        F0 W1XX V W1XYZ
  6290.        W1XX
  6291.        W2ABC
  6292.        W2XXX
  6293.        ---------
  6294.        F0 W1XX V K1XXX,W1XXX
  6295.        W1XX
  6296.        W2ABC
  6297.        W2XXX
  6298.        --------------
  6299.        F0 W8XXX-12
  6300.        W8XXX
  6301.        WA8XXX
  6302.        K7XXX
  6303.        ------------
  6304.  
  6305.        Note: In the previous example we try three different paths to connect
  6306.        to W1XX.  If we get  the messages forwarded the first way the other
  6307.        connections will not be attempted.
  6308.  
  6309.        F0 W1XX
  6310.        !01-04,12,21-23          This will forward during the times indicated
  6311.        W1XX                     (Use of this line is optional, but if used,
  6312.        W2ABC                    must begin with a !  If you wish to
  6313.        W2XXX                    temporarily not forward to a station, or if
  6314.        ----------               you wish to have bulletins not marked as 
  6315.                                 forwarded unless they are polled, use !25)
  6316.  
  6317.  
  6318.        In the list of callsigns given indicating what BBS's msgs can be
  6319.        forwarded to a particular BBS if a second entry is typed on the line
  6320.        then the second entry must match some part of a message title to
  6321.        allow it to be forwarded.  For example,
  6322.  
  6323.        F1 W1XX
  6324.        ARRL DX
  6325.        ----------
  6326.  
  6327.        @ARRL  will be forwarded only if DX appears in their title.  Case of
  6328.        letters is ignored in the comparison.
  6329.  
  6330.  
  6331.  
  6332.  
  6333.        MSYS 1.18                                                   Page 95
  6334.  
  6335.  
  6336.  
  6337.  
  6338.  
  6339.        You can use * in the forward file.  If you have NTS* then all msgs
  6340.        with NTS as the first 3 characters of the @BBS will be forwarded.
  6341.        For example:
  6342.  
  6343.        F1 W1XX
  6344.        NTS*
  6345.        ----------
  6346.  
  6347.        *  used alone is treated specially.  Only messages that have been on
  6348.        the BBS for more than about 2 days will be forwarded.  This gives
  6349.        time for them to be forwarded by other specified connections.
  6350.  
  6351.        IMPORTANT  NOTE:  In the forwarding file, use of * for the BBS names
  6352.        cannot be the first call and the first bbs in the list of BBB's that
  6353.        can be forwarded to through the given bbs MUST  begin with a letter.
  6354.  
  6355.        Example:
  6356.  
  6357.        F0 WA8BXN
  6358.        *         <---- won't work
  6359.        WA8BXN
  6360.        -----------
  6361.        F0 WA8BXN
  6362.        44*       <----- won't work
  6363.        WA8BXN
  6364.        -----------
  6365.        F0 WA8BXN
  6366.        WA8BXN    <----- will work
  6367.        *
  6368.        44*
  6369.        -----------
  6370.  
  6371.        Note: # is a wild card character.  If you want to put #NEOH as an
  6372.        entry in your forward file, you will have to use "#NEOH (the " is an
  6373.        escape character that says the character that follows must match
  6374.        exactly and is not treated as a wildcard character as it normally
  6375.        would be).
  6376.  
  6377.  
  6378.  
  6379.  
  6380.  
  6381.  
  6382.  
  6383.  
  6384.  
  6385.  
  6386.  
  6387.  
  6388.  
  6389.  
  6390.  
  6391.  
  6392.  
  6393.  
  6394.        MSYS 1.18                                                   Page 96
  6395.  
  6396.  
  6397.  
  6398.  
  6399.  
  6400.                              (callsign).FWD/.REV Files
  6401.  
  6402.        One way to reasonably manage large forwarding lists is to create a
  6403.        file for each BBS that you forward to.  The file will take its name
  6404.        from the BBS that you will be forwarding to.  For example, to
  6405.        establish the list of @BBS items to forward to WB8BII, you would
  6406.        create a file called WB8BII.FWD.  In this case, the extension name is
  6407.        not important, but to simplify our explanation, we will use the
  6408.        extension .FWD.  To help manage the lists, you would to set up a
  6409.        C:/MSYS/FWD directory.  In this example,  the file will be:
  6410.        C:/MSYS/FWD/WB8BII.FWD.  In this file, you will list all of the
  6411.        different @BBS and hierarchical addresses you wish to forward.
  6412.  
  6413.        If you wish the other station to also be able to poll you for the
  6414.        catagories, the file_name.ext must be <callsign>.REV.
  6415.  
  6416.        Example:
  6417.  
  6418.        File entry     Comments (NOT IN THE FILE!)
  6419.  
  6420.        WB8BII         Mail with an @BBS of WB8BII
  6421.        KA8Z           Mail with an @BBS of KA8Z
  6422.        OKIPN          Mail with an @BBS of OKIPN
  6423.        NEOH           Mail with an @BBS of NEOH
  6424.        NTSKY          Mail with an @BBS of NTSKY
  6425.        ALL*           Mail with an @BBS of ALL(anything)
  6426.        "#NEOH         Mail with a HIERARCHICAL ADDRESS of .#NEOH
  6427.        OH             Mail with an @BBS OR HIERARCHICAL ADDRESS of OH
  6428.        [OH            Mail with a @BBS of OH
  6429.        ]OH            Mail with a HIERARCHICAL ADDRESS of .OH
  6430.        EU             Mail with a HIERARCHICAL ADDRESS of EU (Europe)
  6431.        442*           Mail to ZIP CODE 442xx
  6432.  
  6433.        The last entry in the table MUST have a carriage return after it.
  6434.        There should be NO blank lines in the file, INCLUDING AT THE END OF
  6435.        THE FILE!
  6436.  
  6437.        It is suggested that perhaps @BBS and hierarchical entries be listed
  6438.        in the file ahead of the more general ALL-type entries.  In the event
  6439.        a logical connection is lost during a forward cycle, at least some of
  6440.        the personal mail will be forwarded ahead of the less urgent "for
  6441.        sale-rusty tower" messages.
  6442.  
  6443.        To implement these (callsign).FWD/.REV Files files, the entry in
  6444.        MSYSFWD.DEF would look like this:
  6445.  
  6446.        ---------
  6447.        F0 WA8BXN
  6448.        $C:\MSYS\FWD\WA8BXN.FWD
  6449.        ---------
  6450.  
  6451.  
  6452.  
  6453.  
  6454.  
  6455.        MSYS 1.18                                                   Page 97
  6456.  
  6457.  
  6458.  
  6459.  
  6460.  
  6461.        The dollar sign ($) at the beginning of the line is very important as
  6462.        it tells MSYS to include the contents of the file defined on that
  6463.        line.  At the time of the automatic merge, or whenever the MERge
  6464.        command is given, the contents of the WA8BXN.FWD file will be
  6465.        included in the MSYSFWD.DEF file to give the final MSYS.FWD file.
  6466.        The included file may be changed anytime, but the results will not
  6467.        take effect until a MERge command has been executed.  Due to the
  6468.        extra overhead of opening, reading, and closing the file, this should
  6469.        only be used for more than just a few call signs.
  6470.  
  6471.  
  6472.                                   REVERSE FORWARD
  6473.  
  6474.  
  6475.        MSYS can respond with messages to a connected BBS when it gives F>.
  6476.        If you wish another bbs to be able to REVERSE FORWARD (i.e. connect
  6477.        TO you and pull the messages listed, rename the file to:
  6478.        <callsign>.REV.  This will permit MSYS then to examine the file and
  6479.        to forward any messages and bulletins to the other bbs upon request.
  6480.        Don't forget, before any bulletins can be forwarded to the other bbs,
  6481.        it must be assigned a number in the MSYSBBSB.DAT file!
  6482.  
  6483.        So you may want to set up your forward file as follows:
  6484.  
  6485.        [file MSYSFWD.DEF]:
  6486.        F0 W8XYZ
  6487.        $c:\msys\fwd\w8xyz.rev
  6488.        --------
  6489.        F0 K8XXX
  6490.        $fwd/k8xxx.dat
  6491.        --------
  6492.  
  6493.  
  6494.        The file C:\MSYS\W8XYZ.REV could look like this:
  6495.        W8XYZ
  6496.        ARRL
  6497.        ALLUS
  6498.  
  6499.  
  6500.        The file C:\MSYS\FWD\K8XXX.DAT could look like this:
  6501.        K8XXX
  6502.        K9XYZ
  6503.        ARRL
  6504.  
  6505.        With these example files, reverse forwarding would be enabled for
  6506.        W8XYZ but not K8XXX.  Recall that $ lines in the forward file
  6507.        MSYSFWD.DEF cause the given file to be included at that point.
  6508.  
  6509.  
  6510.  
  6511.  
  6512.  
  6513.  
  6514.  
  6515.  
  6516.        MSYS 1.18                                                   Page 98
  6517.  
  6518.  
  6519.  
  6520.  
  6521.  
  6522.        When you run the MERge command, the contents of the
  6523.        C:/MSYS/FWD/W8XYZ.REV file will be added to the contents of the
  6524.        MSYSFWD.DEF file to get a combined file listing the routing to W8XYZ
  6525.        and all of the types of messages to be forwarded.  Because the file
  6526.        is in the /FWD directory, and because it has a .REV extension, if
  6527.        W8XYZ should connect to you, your station will reverse forward, or
  6528.        send those items in response to a poll as well.
  6529.  
  6530.        Reverse forwarding is very beneficial to a busy hub bbs as it will
  6531.        help move the mail.  It is not uncommon in a metropolitan area to be
  6532.        forwarding to one bbs while several others are reverse forwarding
  6533.        from you, provided the network capacity is available to handle the
  6534.        traffic.
  6535.  
  6536.        Also remember to be sure to use the MERge command  whenever  you make
  6537.        ANY changes to the forward files!  Reverse forwarding of a given
  6538.        message is not possible until there has been at least one normal
  6539.        forwarding (either forced manually with the FOrward command or at
  6540.        your forward time).  The other half of reverse forwarding (where MSYS
  6541.        would send F> when it is done forwarding messages to a particular
  6542.        station) is enabled with the R in  the first line of the forwarding
  6543.        file (F0 becomes R0 WA8BXN).
  6544.  
  6545.        When done reverse forwarding, MSYS just disconnects and does not send
  6546.        *** done.
  6547.  
  6548.        Reverse forwarding checks if the bbs is currently connected.  If so
  6549.        MSYS will not request reverse forwarding.
  6550.  
  6551.        Reverse forwarding POLL (connects and requests reverse forwarding
  6552.        even if you don't have anything yourself to forward) can be
  6553.        implemented.  Simply place P where you had R or F before.  Thus: F0
  6554.        WA8BXN becomes P0 WA8BXN
  6555.  
  6556.        A check is made to see if asking for another message to be reverse
  6557.        forwarded will overfill the maximum number of messages.
  6558.  
  6559.        Reverse forwarding will check if the required number of attempts at
  6560.        forwarding a message have occurred before reverse forwarding.  Thus
  6561.        if we have OH 25 in the reverse forwarding file, a message that
  6562.        hasn't undergone 25 forwarding attempts will not be reverse forwarded
  6563.        by this entry.
  6564.  
  6565.  
  6566.                                SELECTIVE FORWARDING
  6567.  
  6568.  
  6569.        Selective forwarding by title contents is limited to ONE selection
  6570.        per route.  Thus if you have both ARRL LETTER and ARRL PFB in your
  6571.        forward file for a given bbs,  only bulletins addressed @ARRL with
  6572.        LETTER in their titles will be forwarded.  No other bulletins with
  6573.        @ARRL (including those with PFB in their titles) will be forwarded.
  6574.  
  6575.  
  6576.  
  6577.        MSYS 1.18                                                   Page 99
  6578.  
  6579.  
  6580.  
  6581.  
  6582.  
  6583.        In addition to selective forwarding title comparisons, two additional
  6584.        selection criteria may be specified: number of forward attempts that
  6585.        must be made before using this path or maximum message size to be
  6586.        forwarded using this path.  Here some examples:
  6587.  
  6588.        F0 KA0FPO
  6589.        ARRL
  6590.        NEOH  DX
  6591.        KQ8M  10
  6592.        NEOH  '15
  6593.        OKIPN  <3000
  6594.        OKIPN  '<I
  6595.        -------
  6596.  
  6597.        This set of lines will cause the following to happen.  All @ARRL
  6598.        messages will be forwarded.  Messages with @NEOH will be forwarded if
  6599.        they contain DX (upper and/or lower case) in the title.  Messages
  6600.        with @KQ8M will be forwarded if type is PN and there have been at
  6601.        least 10 forwarding cycles with the message present on the BBS.
  6602.        Messages with @NEOH will be forwarded if there is 15 somewhere in the
  6603.        title.  The single quote mark is used to indicate that the number
  6604.        following is not the number of attempts that must be made to forward
  6605.        the message by other means.  Messages with @OKIPN that are less than
  6606.        3000 bytes long will be forwarded.  And finally messages with @OKIPN
  6607.        and <I in the title (again, case ignored) will be forwarded.  The
  6608.        ability to not use a given forwarding possibility until there have
  6609.        been the specified number of forwarding attempts is included so that
  6610.        preference can be given to favored paths while still allowing
  6611.        alternate paths to be automatically used if the favored ones fail.
  6612.        Limits on message size have been implemented for those who may
  6613.        forward to mini-BBS systems with limited storage capacity.
  6614.  
  6615.  
  6616.  
  6617.  
  6618.  
  6619.  
  6620.  
  6621.  
  6622.  
  6623.  
  6624.  
  6625.  
  6626.  
  6627.  
  6628.  
  6629.  
  6630.  
  6631.  
  6632.  
  6633.  
  6634.  
  6635.  
  6636.  
  6637.  
  6638.        MSYS 1.18                                                   Page 100
  6639.  
  6640.  
  6641.  
  6642.  
  6643.  
  6644.                                 TO FIELD FORWARDING
  6645.  
  6646.  
  6647.        New with MSYS 1.18 is the limited ability to selective forward
  6648.        bulletins based on the TO field as well as the @BBS field.  If, for
  6649.        example, you have a bbs in your area that specializes in satellite
  6650.        items, you may wish to have an entry:
  6651.  
  6652.        ALLUS >AMSAT KEPS OSCAR SATELL SPACE MOON
  6653.  
  6654.        in the included file.  The right arrow indicates to MSYS that the
  6655.        following TO fields @ ALLUS will be forwarded to that particular BBS.
  6656.        The limitation is that there can be only as many different catagories
  6657.        as will fit on one 80 character line.  You may NOT have two lines of
  6658.        ALLUS >.  If more than one line is needed, the bbs should probably
  6659.        get everything anyway.  The TO-FIELD must be specified for each @BBS
  6660.        field it may occur with.  In the above example, TO OSCAR will only be
  6661.        forwarded if it has an @BBS of ALLUS.
  6662.  
  6663.        You may, however have a line for ALLUS and a second one for WW as in
  6664.        the following example:
  6665.  
  6666.        ALLUS >AMSAT KEPS OSCAR SATELL SPACE MOON
  6667.        WW >AMSAT KEPS OSCAR SATELL SPACE MOON
  6668.  
  6669.  
  6670.                                       MERge:
  6671.  
  6672.        This sysop command is automatically done at the startup of MSYS and
  6673.        may be executed by the Sysop while MSYS is running.  If forwarding is
  6674.        in progress, it will execute at the beginning of the next forward
  6675.        cycle.  The command causes MSYS to read the MSYSFWD.DEF file and
  6676.        copies it to MSYS.FWD, expanding any include files ($filename).  A
  6677.        file is also produced, MSYS.BBS that is a sorted list of all possible
  6678.        BBSs that can be forwarded to (including things like ARRL, 44*,
  6679.        etc.).  Any changes you make to your forward files must be done to
  6680.        MSYSFWD.DEF and/or the include files, followed by use of the MERge
  6681.        command (IN THE BBS).
  6682.  
  6683.  
  6684.  
  6685.  
  6686.  
  6687.  
  6688.  
  6689.  
  6690.  
  6691.  
  6692.  
  6693.  
  6694.  
  6695.  
  6696.  
  6697.  
  6698.  
  6699.        MSYS 1.18                                                   Page 101
  6700.  
  6701.  
  6702.  
  6703.  
  6704.  
  6705.                                  FORWARDING NOTES
  6706.  
  6707.        Make sure you don't have any blank lines in your various forward
  6708.        files (MSYSFWD.DEF and the files in the \FWD directory).
  6709.  
  6710.                 Executing Commands From Within the Forwarding File.
  6711.  
  6712.        In the forwarding file, at the beginning of a set of forwarding
  6713.        lines, (i.e., at the beginning of the file or after a ------ line)
  6714.        you can place any sysop command(s) by simply putting \ in front of
  6715.        them.
  6716.  
  6717.        The MSYS.BBS file contains a number after each BBS that the system
  6718.        knows how to forward to.  This is the ORing of all the BBS Masks that
  6719.        can be used to forward the particular @BBS.  This is used to
  6720.        determine when bulletins have been sent to all stations that should
  6721.        be getting them.  when such a bulletin is found, it gets its type
  6722.        changed from $ to # so then it is no longer considered for
  6723.        forwarding.
  6724.  
  6725.        Within the forward file a !timestring line may be placed before any
  6726.        callsign to limit forwarding hours for that callsign (or bulletin
  6727.        route).  The first ! line as used before limits all times for a bbs
  6728.        entry you forward to.  The following ! lines remain in effect until
  6729.        changed by another ! line.  When you start another bbs forward entry
  6730.        group the forwarding hour defaults to 0-23.
  6731.        For Example:   (the comments and blank lines would NOT really be in 
  6732.                       the forward file):
  6733.        F0 WA8BXN      this is the beginning of a forward group
  6734.        !0-16,19-23    don't initiate forwarding during hours of 5 or 6 P.M.
  6735.        WA8BXN         forward the @BBS any time we connect
  6736.        !0-16,22-23    don't forward the following during early evening
  6737.        NTSOH
  6738.        OH
  6739.        !1-4           forward following only in early morning
  6740.        ARRL
  6741.        ALLOH
  6742.        -----
  6743.  
  6744.        Also remember to be sure to use the MERge command  whenever  you make
  6745.        ANY changes to the forward files!  Reverse forwarding of a given
  6746.        message is not possible until there has been at least one normal
  6747.        forwarding (either forced manually with the FOrward command or at
  6748.        your forward time).  The other half of reverse forwarding (where MSYS
  6749.        would send F> when it is done forwarding messages to a particular
  6750.        station) is enabled with the R in  the first line of the forwarding
  6751.        file (F0 becomes R0 WA8BXN).
  6752.  
  6753.        When done forwarding MSYS just disconnects and does not send
  6754.        ***Done.
  6755.  
  6756.  
  6757.  
  6758.  
  6759.  
  6760.        MSYS 1.18                                                   Page 102
  6761.  
  6762.  
  6763.  
  6764.  
  6765.  
  6766.        **** BE SURE TO INCLUDE MSYS in your forward files for all other
  6767.        stations you forward to so I can send bulletins about MSYS to all of
  6768.        you.  The list of MSYS operators keeps growing!
  6769.  
  6770.  
  6771.                                  FORWARDING DISPLAY
  6772.  
  6773.  
  6774.        As each of the BBSs to which msgs can be forwarded is scanned for a
  6775.        given bbs you will see it.  When a message is being forwarded you
  6776.        will see a line that gives its number and the to station and @bbs of
  6777.        the message.  In parenthesis you will see the entry in the forward
  6778.        file that is being used.  Thus if the forwarding file contained.
  6779.  
  6780.        F0 WA8BXN
  6781.        WA8BXN
  6782.        44*
  6783.        ---------
  6784.        and there was a message for K8ZZZ@44123 being forwarded you would see
  6785.        something like:
  6786.         Fwding msg # 123 K8ZZZ@44123(44*). QSLDX @BBS:
  6787.  
  6788.        Messages that arrive with @BBS of IDCALL get the @BBS field changed
  6789.        to --- .  This makes them distinctive
  6790.  
  6791.        Messages sent to REQQTH, REQDIR and REQFIL are left private if they
  6792.        arrive that way.
  6793.  
  6794.        ***  There can only be up to 400 different bbs names in the
  6795.        forwarding file.  To check this do a LCount on the file MSYS.BBS.
  6796.  
  6797.  
  6798.                                        BIDS
  6799.  
  6800.        Messages that are entered on the system addressed to other than what
  6801.        looks like a callsign automatically get a BID generated for them.
  6802.  
  6803.        Mail forwarded to BBSs identifying with either [MBL or [.. - $ ] get
  6804.        the BID included in the S command line.
  6805.  
  6806.        BIDs may also be added to the message R: line with the RB on command.
  6807.  
  6808.  
  6809.  
  6810.  
  6811.  
  6812.  
  6813.  
  6814.  
  6815.  
  6816.  
  6817.  
  6818.  
  6819.  
  6820.  
  6821.        MSYS 1.18                                                   Page 103
  6822.  
  6823.  
  6824.  
  6825.  
  6826.  
  6827.  
  6828.                                      Wildcards
  6829.  
  6830.  
  6831.        Wildcards (where you can use *) have been enhanced to allow more than
  6832.        just using *.  Based upon the recommendations of AA4RE and others,
  6833.        the following have been implemented:
  6834.  
  6835.        * Matches 0 or more occurrences of anything
  6836.        @ a..z, A..Z
  6837.        # 0..9
  6838.        + a..z, A..Z, 0..9
  6839.        ? a..f, A..F, 0..9 (hex digits)
  6840.        < a..z
  6841.        > A..Z
  6842.        $ =@#+?<>$     (any one of those characters, but I don't have any
  6843.        guesses as to why this group was included)
  6844.        = any one character
  6845.        " the escape character: the next character must match exactly
  6846.        ( beginning of group . (abc) matches a b or c.
  6847.  
  6848.        Examples: 9v1A2q   matches #@#@#@
  6849.              95===  matches anything 5 characters long beginning
  6850.                     with 95
  6851.             (WK)6   matches anything starting with W6 or K6 (case
  6852.                     is important)
  6853.              95###   matches any 5 digit number beginning with 95
  6854.  
  6855.  
  6856.                               MISSING TEXT TO Message
  6857.  
  6858.  
  6859.        If the text for a message is not available when it is being
  6860.        forwarded, the forwarding is aborted instead of sending out a missing
  6861.        text message for the text.  The STatus command will now indicate how
  6862.        many times this has occurred and the last message number for which it
  6863.        happened.  In addition, an entry will be made in the event.log file.
  6864.        The MISsing command may also be used to determine how many times this
  6865.        occurred without generating all of the other STatus output.
  6866.  
  6867.  
  6868.  
  6869.  
  6870.  
  6871.  
  6872.  
  6873.  
  6874.  
  6875.  
  6876.  
  6877.  
  6878.  
  6879.  
  6880.  
  6881.  
  6882.        MSYS 1.18                                                   Page 104
  6883.  
  6884.  
  6885.  
  6886.  
  6887.  
  6888.                                    NODe Scripts
  6889.  
  6890.  
  6891.        The script consists of several sets of lines.  The first line begins
  6892.        with  @  followed immediately by the call (and Via digipeater list if
  6893.        needed) of the NODe to initially connect to.  The port that will be
  6894.        used is taken from the digit after the F on the first line in the
  6895.        group.  If the connection is established to the NODe, the following
  6896.        sets of lines are used to talk to the first NODe and possibly other
  6897.        nodes called through it.
  6898.  
  6899.        Each set of lines for a given NODe begins with a line that has a
  6900.        period in position one.  The following characters on the line are
  6901.        sent to the NODe as a command.  The next line in the set is optional
  6902.        and if used has  #  in the first position.
  6903.  
  6904.        Following this is the number of seconds to wait before abandoning use
  6905.        of this NODe.  If this line is not given then 60 seconds will be
  6906.        assumed.
  6907.  
  6908.        The next line is required and begins with  +  in the first position.
  6909.        The following characters are what are looked for in lines that come
  6910.        from the NODe to indicate that connection has been established to the
  6911.        station called (another NODe or the desired BBS).  An exact match to
  6912.        the characters given on the line (including case) must be found
  6913.        somewhere in a line received to continue.
  6914.  
  6915.        Next come two lines beginning with  ?  in the first position.  These
  6916.        lines contain strings of characters that if found anywhere in a line
  6917.        that comes from the NODe that the connection was not made.  Thus
  6918.        after we issue the connect command (given on the line beginning with
  6919.        .) one of three things can happen: a line from the NODe that matches
  6920.        the +string is found and we continue with the script or talk to the
  6921.        BBS, a line from the NODe matches a ?string which means we give up on
  6922.        making the connection, or a time-out occurs waiting for a match which
  6923.        again means we will give up the connection.
  6924.  
  6925.        Example scripts:
  6926.  
  6927.        These strings are useful for KA Nodes.
  6928.         @ANOD    (issue connect command to ANOD)
  6929.         .C       (issue connect to desired call)
  6930.         #25      (time out after 25 seconds if no match)
  6931.         +MADE    (if MADE comes from NODe, continue)
  6932.         ?BUSY    (if BUSY comes from NODe, abandon attempt)
  6933.         ?RETRIED (if RETRIED comes from NODe, abandon attempt)
  6934.  
  6935.  
  6936.        For a NET/ROM NODe the following would be useful:
  6937.        +to
  6938.        ?Failure
  6939.        ?Busy
  6940.  
  6941.  
  6942.  
  6943.        MSYS 1.18                                                   Page 105
  6944.  
  6945.  
  6946.  
  6947.  
  6948.  
  6949.        Here is another example of a complete forward file:
  6950.  
  6951.         F1 W8XXX
  6952.         W8XXX
  6953.         W5XYZ
  6954.         ---------
  6955.         F0 W4XYZ
  6956.         @W7XXX
  6957.         .C W9XXX
  6958.         +to
  6959.         ?Busy
  6960.         ?Failure
  6961.         .C W4XXX
  6962.         #120
  6963.         +MADE
  6964.         ?RETRIED
  6965.         ?BUSY
  6966.         W4XYZ
  6967.         W4XXX
  6968.         -------
  6969.         F1 W9XXX-2 VIA K9XXX-3,KA9XXX
  6970.         W9XXX
  6971.         W1XXX
  6972.         W3XXX
  6973.         K0XXX
  6974.         ----------
  6975.  
  6976.        NOTE:  The forward connect script for a given bbs is limited  to 25
  6977.        lines.
  6978.  
  6979.  
  6980.  
  6981.  
  6982.  
  6983.  
  6984.  
  6985.  
  6986.  
  6987.  
  6988.  
  6989.  
  6990.  
  6991.  
  6992.  
  6993.  
  6994.  
  6995.  
  6996.  
  6997.  
  6998.  
  6999.  
  7000.  
  7001.  
  7002.  
  7003.  
  7004.        MSYS 1.18                                                   Page 106
  7005.  
  7006.  
  7007.  
  7008.  
  7009.  
  7010.                                MSYS NODe Forwarding
  7011.  
  7012.        You can forward directly through your own MSYS node (assuming  it is
  7013.        properly activated).  Here are some examples how to do it:
  7014.  
  7015.        F0 W8XYZ  This is the station we are forwarding to, the number
  7016.        %W8XYZ    after F is not important.  Then do a network connect to 
  7017.                  W8XYZ - assuming  W8XYZ is in our local dest list
  7018.        W8XYZ     forward @ W8XYZ stuff to this bbs
  7019.        -------
  7020.        F0 W8XYZ
  7021.        %W8XXX    {connect to node W8XXX which is in our local dest list}
  7022.        +to
  7023.        ?busy
  7024.        W8XYZ     stuff to forward to this bbs
  7025.        -------
  7026.                  NOTE:  There should be NO BLANK LINES in this file!
  7027.  
  7028.  
  7029.                             FORWARDING TO JNOS SYSTEMS
  7030.  
  7031.  
  7032.        TO forward to a JNOS TCP/IP mailbox the file may look like
  7033.        the following.
  7034.        ---------------
  7035.        F0 W8UPD
  7036.        .
  7037.        +NET (may not be needed)
  7038.        W8UPD
  7039.        (MORE @BBS CALLS)
  7040.        ---------------
  7041.  
  7042.        Another way that also seems to work:
  7043.  
  7044.        ---------------
  7045.        f0 w8upd
  7046.        %UAKRON
  7047.        $c:\msys\fwd\w8upd.rev
  7048.        ---------------
  7049.        Please note that some JNOS systems may require you to make the final
  7050.        connect to the ALIAS rather than to the callsign of the bbs.  There
  7051.        is a command in JNOS that probably should be used: mbox jumpstart  to
  7052.        permit the JNOS system to start the handshake sequence without
  7053.        awaiting the extra carriage return.
  7054.  
  7055.  
  7056.  
  7057.  
  7058.  
  7059.  
  7060.  
  7061.  
  7062.  
  7063.  
  7064.  
  7065.        MSYS 1.18                                                   Page 107
  7066.  
  7067.  
  7068.  
  7069.  
  7070.  
  7071.                                    HF FORWARDING
  7072.  
  7073.        HF Forwarding regulations do not allow transmitting 3rd party traffic
  7074.        unless there is a control operator present, the station is under
  7075.        remote control, or a STA has been issued.  To aid in compliance with
  7076.        the regulations, the ATtended command has been added.  When set to ON
  7077.        all forwarding is allowed.  If off, ports with radio speed of 300
  7078.        will forward only those messages in which the from call is the idcall
  7079.        (messages that you originate) or the to station in the message is the
  7080.        station you would directly connect to for forwarding.  HF reverse
  7081.        forwarding is also inhibited if ATtended is OFF.  Note that the
  7082.        regulations appear to allow you to receive messages unattended.  So
  7083.        if you don't have a STA for HF turn AT OFF when you aren't there and
  7084.        remember to turn it ON when you are.  To be on the safe side, put
  7085.        ATtended OFF in your MSYS.DO file should the system reboot when you
  7086.        aren't present.
  7087.  
  7088.  
  7089.                                  PACTOR FORWARDING
  7090.                                   GTOR FORWARDING
  7091.  
  7092.        The commands for PACTOR and GTOR are essentially the same, with the
  7093.        obvious difference in the mode of the TNC.  Automated forwarding
  7094.        should not be done using PACTOR/GTOR. However, reverse forwarding can
  7095.        move traffic off a remote PBBS.  A MSYSFWD.DEF-like file is made with
  7096.        a filename of your choice.  This will serve as a manual forwarding
  7097.        file.
  7098.  
  7099.             The following is an example of a pactor forward file:
  7100.  
  7101.        Filename = NO8M.PAC
  7102.             p0 no8m
  7103.             wa8bxn
  7104.             wb8bii
  7105.             k8eiw
  7106.             -----
  7107.  
  7108.        Only callsigns or routes can be in this list.  You can NOT have the
  7109.        $filename.ext type of include file.
  7110.  
  7111.        The above causes a connect to NO8M and sends traffic for the three
  7112.        listed PBBS stations.  A reverse forward prompt then results in
  7113.        traffic for the connecting station to be reverse forwarded.
  7114.  
  7115.  
  7116.  
  7117.  
  7118.  
  7119.  
  7120.  
  7121.  
  7122.  
  7123.  
  7124.  
  7125.  
  7126.        MSYS 1.18                                                   Page 108
  7127.  
  7128.  
  7129.  
  7130.  
  7131.  
  7132.  
  7133.        When you wish to manually forward, enter the following command from
  7134.        the sysop keyboard:
  7135.  
  7136.             FP filename.ext
  7137.        or in the previous example:
  7138.             FP NO8M.PAC
  7139.  
  7140.        MSYS then acts on your file and forwards via the PACTOR/ GTOR port.
  7141.        MSYS can have a "normal" forwarding session in progress at the same
  7142.        time as it is forwarding via PACTOR/GTOR.
  7143.  
  7144.        DO NOT ENABLE DIGI ON YOUR PACTOR/GTOR PORT!!
  7145.  
  7146.        DON'T FORGET TO ENABLE CW ID IN YOUR PACTOR/GTOR TNC!!
  7147.  
  7148.        MSYS does not yet support the new Kantronics TOR mode automatic
  7149.        switching.
  7150.  
  7151.  
  7152.  
  7153.  
  7154.  
  7155.  
  7156.  
  7157.  
  7158.  
  7159.  
  7160.  
  7161.  
  7162.  
  7163.  
  7164.  
  7165.  
  7166.  
  7167.  
  7168.  
  7169.  
  7170.  
  7171.  
  7172.  
  7173.  
  7174.  
  7175.  
  7176.  
  7177.  
  7178.  
  7179.  
  7180.  
  7181.  
  7182.  
  7183.  
  7184.  
  7185.  
  7186.  
  7187.        MSYS 1.18                                                   Page 109
  7188.  
  7189.  
  7190.  
  7191.  
  7192.  
  7193.                                   SMTP FORWARDING
  7194.  
  7195.  
  7196.        Sample entry in MSYSFWD.DEF:
  7197.  
  7198.        T 44 70 241 1   (DO NOT USE DOTS IN THE ADDRESS)
  7199.        W8UPD
  7200.        -----
  7201.        Note that no port number is specified, it does an arp if needed.
  7202.        Also note no digis (put them in the arp table if you have to have
  7203.        them).  No nodes.  Just T and the IP address of the DEStination
  7204.        station as shown.  This corresponds to the line like F0 W8UPD.  Next
  7205.        comes the @BBS values to send to this station.  There can be more
  7206.        than one.  Then the ------ that ends this entry.  The same forward
  7207.        file is used for both normal  forwarding and tcp/ip stuff.  I have
  7208.        also made some changes to the SMTP command.  After you use it, if you
  7209.        type PRompt it will prompt you for To: (enter call@bbs) Reply-to:
  7210.        (just hit return if you like the default given) Subject: (this is in
  7211.        the body of the text, not the title) Then you enter your text and end
  7212.        with.  (not ^Z) as instructed.  The result is a message that contains
  7213.        all the fancy extra lines often found in tcp/ip messages.
  7214.  
  7215.        Bulletins may be forwarded using SMTP. IMPORTANT: SEE NOTE BELOW  To
  7216.        do so you must assign the SMTP station an entry in the MSYSBBSB.DAT
  7217.        file like you would for normal forwarding (don't use any SSIDs).
  7218.        Also add the callsign of the station in the T line in the forward
  7219.        file after the IP address.  Example: T 44 70 242 6 WB8BII  This
  7220.        should be done in the forwarding file for all SMTP forwarding.
  7221.  
  7222.        Bulletins are accepted from SMTP (a bulletin goes to a non-callsign).
  7223.        BIDs are made up based on your message number and callsign.
  7224.  
  7225.        Hierarchical addresses are added to msgs that come in via SMTP.
  7226.  
  7227.        NOTE: Since BIDs are not supported in this implementation of SMTP,
  7228.        bulletins can either be sent to or received from TCP/IP systems but
  7229.        not both ways.
  7230.  
  7231.        MSYS will accept <RCPT TO>: lines in either the format a%b@c or b!a@c
  7232.        where c is your bbs call, a is the destination stations call and b is
  7233.        the destinations bbs.  Both of these get transformed into a@b on the
  7234.        MSYS message list.
  7235.  
  7236.  
  7237.  
  7238.  
  7239.  
  7240.  
  7241.  
  7242.  
  7243.  
  7244.  
  7245.  
  7246.  
  7247.  
  7248.        MSYS 1.18                                                   Page 110
  7249.  
  7250.  
  7251.  
  7252.  
  7253.  
  7254.                              FBB COMPATIBLE FORWARDING
  7255.  
  7256.        MSYS follows the standard established by F6FBB in his version 5.14
  7257.        and 5.15 of his BBS software.
  7258.  
  7259.        As described in the FBB manual, once the F letter in the SID (System
  7260.        type IDentifier) has been detected, all command lines must start in
  7261.        the first column with the 'F' character.  All command lines are
  7262.        terminated by a return (CR) character.  When the connection to
  7263.        another bbs using the FBB protocol has been made and the 'F' flag has
  7264.        been received, the SID of the local station is sent with the first
  7265.        proposal.  The proposal may look something like this:
  7266.  
  7267.        FB P WA8BXN WB8BII K8EIW 12345_WA8BXN 765
  7268.        F>
  7269.  
  7270.        Where:
  7271.  
  7272.        FB             Type of command (proposal)
  7273.        P              Type of message (P = personal, B = bulletin)
  7274.        WA8BXN         Sender (From field)
  7275.        WB8BII         BBS of recipient (@BBS)
  7276.        K8EIW          Recipient (To field)
  7277.        12345_WA8BXN   BID or MID
  7278.        765            Size of message in bytes
  7279.        F>             End of proposal
  7280.  
  7281.        In the case of multiple message proposals, the 'FB' line is sent for
  7282.        each message proposed followed by one F>.
  7283.  
  7284.        Upon receiving the proposals, the other BBS will accept or reject the
  7285.        message with the command line:
  7286.  
  7287.        FS -+=
  7288.        where
  7289.        -    means No, already have that message
  7290.        +    means Yes, send the message
  7291.        =    assumed by MSYS to be No, message being forwarded by another 
  7292.             system.
  7293.  
  7294.        The FS line must have as many +,- signs as  FB lines in the proposal.
  7295.  
  7296.        Each message is sent with the title on the first line, the text, and
  7297.        a control Z in the last line.  There are NO blank lines between
  7298.        messages.
  7299.  
  7300.        When the other BBS has received all the messages in the group, it
  7301.        acknowledges by sending its proposal and the direction of forwarding
  7302.        is reversed.
  7303.  
  7304.        If the receiving bbs has no further messages to send, it responds
  7305.        with a:   FF
  7306.        This line must NOT be followed by a F>.
  7307.  
  7308.  
  7309.        MSYS 1.18                                                   Page 111
  7310.  
  7311.  
  7312.  
  7313.  
  7314.  
  7315.  
  7316.        If the sending BBS has no further messages, it responds with a:
  7317.  
  7318.        FQ
  7319.  
  7320.        and then disconnects.
  7321.  
  7322.  
  7323.                        FBB COMPATIBLE COMPRESSED FORWARDING
  7324.  
  7325.        The protocol utilized for the transfer of compressed messages is an
  7326.        extension to the standard FBB protocol.  Compressed forwarding is
  7327.        validated by the presence of the letter B in the SID [MSYS-1.14-
  7328.        BFHM$].
  7329.  
  7330.        In the case of compressed forwarding, the proposal line begins with
  7331.        a:
  7332.  
  7333.        FA
  7334.  
  7335.        FA means that the transfer will be an ASCII compressed message.
  7336.  
  7337.             The proposal to send a message is in the form:
  7338.  
  7339.        FA P WA8BXN WB8BII K8EIW 12345_WA8BXN 6789
  7340.  
  7341.  
  7342.        Compressed message transfer is done in a binary mode, which is
  7343.        derived from the YAPP protocol.  All transfers consist of a header, a
  7344.        block of data, an end of message and a checksum.  Each transfer is
  7345.        equivalent to the transfer of one message of the standard protocol,
  7346.        but is not followed by a control Z.  The end of file specifier is
  7347.        defined by the transmission of a EOT character followed by a 1 byte
  7348.        checksum..
  7349.  
  7350.  
  7351.  
  7352.  
  7353.  
  7354.  
  7355.  
  7356.  
  7357.  
  7358.  
  7359.  
  7360.  
  7361.  
  7362.  
  7363.  
  7364.  
  7365.  
  7366.  
  7367.  
  7368.  
  7369.  
  7370.        MSYS 1.18                                                   Page 112
  7371.  
  7372.  
  7373.  
  7374.  
  7375.  
  7376.        Format of the header for a compressed message:
  7377.  
  7378.             <SOH> 1 byte = 01 hex
  7379.             Length of the header 1 byte = Length from the title,
  7380.             Title of the message 1 to 80 bytes
  7381.             <NUL> 1 byte = 00 hex
  7382.             Offset 1 to 6 bytes
  7383.             <NUL> 1 byte = 00 hex
  7384.  
  7385.  
  7386.        To follow the FBB format, the title of the message is transmitted in
  7387.        ASCII, not compressed.
  7388.  
  7389.        The offset is also transmitted in ASCII and specifies the offset at
  7390.        which the data should be inserted in the file (in case of a
  7391.        fragmented file).  A data block contains from one to 256 bytes.  It
  7392.        begins by two bytes which specify the format:
  7393.  
  7394.             <STX> 1 byte = 02 hex
  7395.             Number of data 1 byte = 00 to FF hex. (00 if length = 256
  7396.        bytes).
  7397.             Data bytes 1 to 256 bytes
  7398.  
  7399.        The last data block is followed by the end of transmission character
  7400.        (EOT) and the checksum in the format:
  7401.  
  7402.             <EOT> 1 byte = 04 hex
  7403.             Checksum 1 byte = 00 to FF hex
  7404.  
  7405.        The checksum is equal to the sum of all the data bytes of the
  7406.        transmitted file, modulo 256 (8 bits) and then two's complemented.
  7407.  
  7408.        The checking of the checksum is very simple:
  7409.  
  7410.             The sum of the data from the file and the checksum received
  7411.        modulo    256 (anded with FF) shall be equal to zero.
  7412.  
  7413.        In case of a checksum error, the message is not accepted and the
  7414.        system sends the comment
  7415.  
  7416.             *** Checksum error
  7417.  
  7418.        and issues a disconnect request.
  7419.  
  7420.        The transmission sequence is repeated for each message in the group.
  7421.  
  7422.  
  7423.  
  7424.  
  7425.  
  7426.  
  7427.  
  7428.  
  7429.  
  7430.  
  7431.        MSYS 1.18                                                   Page 113
  7432.  
  7433.  
  7434.  
  7435.  
  7436.  
  7437.  
  7438.        W0RLI STANDARD FOR DATA COMPRESSION DURING THE FORWARDING OF MESSAGES
  7439.                          IN THE AMATEUR RADIO BBS NETWORK
  7440.  
  7441.               ihave/iwant variable batch size protocol
  7442.               Feature letter X, commands SS, SX, SY
  7443.               LZH compression
  7444.  
  7445.        --------------------------------------------------------------------
  7446.        Command Definitions and BNF description.
  7447.        --------------------------------------------------------------------
  7448.  
  7449.        N              = INTEGER, size 32 bits.
  7450.        protocol       = TBD
  7451.        batch_size     = N
  7452.        file_size      = N
  7453.        msg_count      = <0-25>
  7454.  
  7455.        id             = BID | MID EOL
  7456.        ids            = id | ids id
  7457.  
  7458.        byte           = <0x00 - 0xff>
  7459.        bytes          = byte | bytes byte
  7460.  
  7461.        ihave = "SX" msg_count [" " protocol] [" " batch_size] EOL [ids]
  7462.        iwant = "SY" msg_count EOL [ids]
  7463.        isend = "SS" file_size EOL bytes
  7464.  
  7465.        For ihave:
  7466.        Protocol and batch_size not used in initial implementation.
  7467.        Default protocol is : LZH <C source provided>
  7468.  
  7469.        For iwant:
  7470.        SY means want only there.
  7471.  
  7472.        --------------------------------------------------------------------
  7473.        The basic interchange (example):
  7474.        --------------------------------------------------------------------
  7475.        bn are BIDs (or MID if message has no BID).
  7476.        m: is master, s: is slave.
  7477.  
  7478.        m: SX 5
  7479.        m: b1
  7480.        m: b2
  7481.        m: b3
  7482.        m: b4
  7483.        m: b5
  7484.  
  7485.        s: SY 3
  7486.        s: b1
  7487.        s: b3
  7488.        s: b5
  7489.  
  7490.  
  7491.  
  7492.        MSYS 1.18                                                   Page 114
  7493.  
  7494.  
  7495.  
  7496.  
  7497.  
  7498.        m: SS 26545
  7499.        m: <sends 26545 byte file>
  7500.  
  7501.        In the case of any error, the station noticing the error must
  7502.        disconnect.
  7503.        --------------------------------------------------------------------
  7504.        With more detail of one implementation (MB/SERVER processing)
  7505.        --------------------------------------------------------------------
  7506.        From Sending side:
  7507.  
  7508.        MB:
  7509.        Scan messages to find batch not larger than max. batch size.
  7510.        Keep record numbers and cc: id in list.
  7511.        Send ihave.
  7512.        Receive iwant.
  7513.        Mark all messages in ihave and not in iwant as forwarded (dup bid)
  7514.        Pass iwant list to SERVER in file.
  7515.        Wait for server acknowledge.
  7516.  
  7517.        SERVER:
  7518.        Create export file.
  7519.        Compress export file.
  7520.        Signal MB that compressed file is ready to send.
  7521.  
  7522.        MB:
  7523.        Send isend, send the file.
  7524.        Receive prompt.
  7525.        Mark all messages in iwant as forwarded.
  7526.  
  7527.        From the receiving side:
  7528.  
  7529.        MB:
  7530.        Receive ihave.
  7531.        Check BIDs in ihave.
  7532.        for all non-dup BIDs, make iwant list.
  7533.        Send iwant.
  7534.        Receive compressed file.
  7535.        Signal SERVER import file available.
  7536.        Send prompt.
  7537.  
  7538.        SERVER:
  7539.        Decompress file, import messages.
  7540.  
  7541.  
  7542.  
  7543.  
  7544.  
  7545.  
  7546.  
  7547.  
  7548.  
  7549.  
  7550.  
  7551.  
  7552.  
  7553.        MSYS 1.18                                                   Page 115
  7554.  
  7555.  
  7556.  
  7557.  
  7558.  
  7559.  
  7560.                            FORWARDING ON THE MODEM PORT
  7561.  
  7562.             LET'S PAUSE FOR A MOMENT ... DO NOT FORWARD WITH MSYS ON A
  7563.        TELEPHONE LINE UNLESS YOU ARE ABLE TO INITIATE A ERROR CORRECTING
  7564.        CONNECT WITH THE MODEM.  A NON-ERROR CORRECTING CONNECT WILL MAKE
  7565.        YOUR STATION RESPONSIBLE FOR GARBLED, JUMBLED AND MESSED UP MESSAGES.
  7566.  
  7567.        ALSO: DO NOT ATTEMPT FBB COMPATABLE OR COMPRESSED FORWARDING VIA THE
  7568.        MODEM PORT.  YOU WILL OVERRUN THE AVAILABLE BUFFERS!
  7569.  
  7570.        The FWD.DEF file defines the script MSYS uses to establish a
  7571.        forwarding session.
  7572.  
  7573.        In the FWD.DEF file, put a  F#, R#, or P# line followed by the @BBS
  7574.        items to forward. The format of the F, R and P lines are identical
  7575.        except for the letter.  This format is different from what would be
  7576.        used for packet forwarding and is as follows:
  7577.  
  7578.                  F# callsign phone# callword password
  7579.                  $fwd/<call.rev>
  7580.  
  7581.        where #        is the port number,
  7582.        callsign       is the call of the station you are forwarding to,
  7583.        phone#         is the string to send to the modem to dial,
  7584.        callword       is the reply to give to Call:, and
  7585.        password       is the reply to give to Password: (questions asked by 
  7586.                            the destination MSYS system)
  7587.        $fwd/<call.rev>     is the directory and file which contains the 
  7588.                                 forwarding information
  7589.  
  7590.        Example:
  7591.  
  7592.                  F1 WA8BXN ATDP5551212 swiss normal
  7593.                  $fwd/wa8bxn.rev
  7594.  
  7595.        NOTE: The log-in callword and password are converted to UPPER CASE.
  7596.        Thus the station you are calling must have UPPER CASE values for your
  7597.        callword and password.  The station you are calling must be running
  7598.        MSYS 1.11 or higher.
  7599.  
  7600.        NOTE: The included file in the above example will be in the MSYS/FWD
  7601.        directory.
  7602.  
  7603.  
  7604.  
  7605.  
  7606.  
  7607.  
  7608.  
  7609.  
  7610.  
  7611.  
  7612.  
  7613.  
  7614.        MSYS 1.18                                                   Page 116
  7615.  
  7616.  
  7617.  
  7618.  
  7619.  
  7620.  
  7621.                                  FBB ON THE PHONE
  7622.  
  7623.        FBB style forwarding (compressed or not) should NOT be used on the
  7624.        modem.  Compresssed forwarding just won't work and the non compressed
  7625.        mode has a high likelyhood of overrunning buffers on long messages
  7626.        because of the continuous transmission stream of a block of messages.
  7627.        Therefore, the FBBC parameter MUST be set to 0 for the modem port.
  7628.        "Normal" forwarding to and from FBB systems is possible however
  7629.  
  7630.        Use ONLY FBBC 0 and XO OFF on modem ports. Very Important!!!
  7631.  
  7632.        Use of control characters in the call and/or password should not be
  7633.        needed.  The callsign must be prefixed with a period to turn off
  7634.        echoing from the  FBB system. Here is an example forward file entry
  7635.  
  7636.             F2 K8EIW ATDP5551212 .WA8BXN MSYS
  7637.  
  7638.        The F2 could be R2 or P2 to ask for reverse forwarding or to always
  7639.        poll respectively. The 2 can be replaced by whatever port number your
  7640.        modem is connected to.
  7641.  
  7642.        K8EIW is the call of the bbs to which we are forwarding.
  7643.  
  7644.        ATDP5551212 is the telephone number to call. The P could be replaced
  7645.        by T if tone instead of pulse dialing is desired.
  7646.  
  7647.        .WA8BXN specifies the "callsign" value to be give. The period says to
  7648.        FBB systems to turn off echoing. The actual callsign value used by
  7649.        FBB is just the WA8BXN part.
  7650.  
  7651.        MSYS is the "password" value that will be sent to the FBB system.
  7652.  
  7653.        This example is for forwarding to FBB systems. When forwarding to a
  7654.        MSYS system the only difference is that the period is NOT used in the
  7655.        "callsign" field.
  7656.  
  7657.  
  7658.                             FORWARDING TO AA4RE SYSTEMS
  7659.  
  7660.        It has been reported that for MSYS to forward to a 4RE bbs via land
  7661.        line, the 4RE bbs needs to change the responses in the MESSAGE.BB
  7662.        file.  First, change MESSAGE 95 N to: Call:   and MESSAGE 96 N to:
  7663.        Password:  These two changes have been tested between KI7HM (MSYS and
  7664.        KD7HP (4RE) and are reported to work ok. (Thankyou Gentlemen!)
  7665.  
  7666.  
  7667.  
  7668.  
  7669.  
  7670.  
  7671.  
  7672.  
  7673.  
  7674.  
  7675.        MSYS 1.18                                                   Page 117
  7676.  
  7677.  
  7678.  
  7679.  
  7680.  
  7681.  
  7682.                                 ANONYMOUS CHECK-INS
  7683.  
  7684.        It is possible to set up the modem port to take a call from an
  7685.        anonymous check-in.  As long as all outgoing traffic is held, people
  7686.        interested in ham radio, awaiting their license or whatever can read
  7687.        and send traffic.  As long as ALL outgoing anonymous traffic is held,
  7688.        there are no legal implications.  MSYS is designed so that if someone
  7689.        uses the string "visit" for both the call and the password, and if
  7690.        visit is in the MSYSPASS.MOD,  MSYS will allow a check in.  Here is
  7691.        how the MSYSPASS.MOD should be set up:
  7692.  
  7693.                  VISIT VISIT V1SIT
  7694.                  Visit Visit V1SIT
  7695.                  visit visit V1SIT
  7696.                  (other calls follow)
  7697.  
  7698.        By having all the various combinations of case, a anonymous check-in
  7699.        does not have to worry about the case that is used.  Now, it is
  7700.        CRITICAL that MSYSHOLD.DAT have the lines "connected=v1sit" and
  7701.        "from=v1sit".  All anonymous traffic will be held.  It can then be
  7702.        routinely deleted or readdressed by the sysop (with the sysop's call
  7703.        being used for the sending party).
  7704.  
  7705.        It is also necessary to use the "EU V1SIT" command to add the user to
  7706.        your system.  Here is what the file will look like when done:
  7707.  
  7708.             V1SIT is VISITOR located at VISITOR  Last new message 19485
  7709.             Last connected Fri Mar 19 23:10:57 1994 on port 5
  7710.             Flags=$0140 Lines=20
  7711.             Postal code: VISITOR  Home BBS: NO8M  Last WP Update: Mar 10
  7712.        08:41:01 1994
  7713.             Path to V1SIT is Direct
  7714.  
  7715.        Other calls than V1SIT can be used, however MSYS is programmed to
  7716.        disallow changes to the V1SIT callsign's information.  An anonymous
  7717.        check-in can not go in and change V1SIT's home PBBS, name, etc.
  7718.  
  7719.        Also, please note that the "FLAGS" for V1SIT are set at $140 to
  7720.        prevent erroneous WP messages from being generated!
  7721.  
  7722.  
  7723.  
  7724.  
  7725.  
  7726.  
  7727.  
  7728.  
  7729.  
  7730.  
  7731.  
  7732.  
  7733.  
  7734.  
  7735.  
  7736.        MSYS 1.18                                                   Page 118
  7737.  
  7738.  
  7739.  
  7740.  
  7741.  
  7742.        It helps to have a help file that tells the anonymous users something
  7743.        about how to get help.  Here is an example MSYSMOD.MSG:
  7744.  
  7745.        *******************************************
  7746.        ** Welcome to the NCARC MSYS Modem Port! **
  7747.        *******************************************
  7748.  
  7749.        For information on the system, use "I".  To a list of messages on
  7750.             the board, use the command "L 0".  To see what is in the
  7751.             download section, use the command "W".  (Use "D FILES.LST" and
  7752.             "D README.DOC" for information on how to get those files.)  A
  7753.             MSYS User's Manual is available and how to get it is in the
  7754.             file USERMAN.INF.)  Please DO use this modem port for
  7755.             downloading the LONG files I have here ... we have PART 97 of
  7756.             the FCC Regulations and other very long files that are
  7757.             inappropriate for downloading by a RF link.
  7758.  
  7759.        If you are interested in amateur radio and how to get your license
  7760.             leave me a message (SP NO8M or SP SYSOP) and I will get you in
  7761.             touch with someone that can help.
  7762.  
  7763.        -----end of MSYSMOD.MSG
  7764.  
  7765.        Anonymous use of the port will be in direct proportion to the
  7766.        advertising that is done outside of amateur circles.  If you make up
  7767.        fliers and distribute them, you will see port usage rise.
  7768.  
  7769.  
  7770.  
  7771.  
  7772.  
  7773.  
  7774.  
  7775.  
  7776.  
  7777.  
  7778.  
  7779.  
  7780.  
  7781.  
  7782.  
  7783.  
  7784.  
  7785.  
  7786.  
  7787.  
  7788.  
  7789.  
  7790.  
  7791.  
  7792.  
  7793.  
  7794.  
  7795.  
  7796.  
  7797.        MSYS 1.18                                                   Page 119
  7798.  
  7799.  
  7800.  
  7801.  
  7802.  
  7803.  
  7804.                               ACOUSTIC COUPLED MODEMS
  7805.  
  7806.        There are times that you may want to utilize an acoustically coupled
  7807.        modem port.  This might be needed when you want to forward
  7808.        automatically from a pay phone.  The MSYSFWD.DEF line in this set up
  7809.        would read like this:
  7810.                  -----
  7811.                  R0 NO8M ATX1D callword password
  7812.                  $FWD\NO8M.REV
  7813.                  -----
  7814.        A callword and password that is a unique, pretend user is set up.  If
  7815.        the callword and password were BOZO and CLOWN, the following line
  7816.        could be used in your MSYSPASS.MOD:
  7817.                  BOZO CLOWN N08M
  7818.  
  7819.        The pretend callsign N08M would then be set up on the home PBBS to
  7820.        forward what you wanted.  You would add the pretend call to your home
  7821.        MSYSFWD.DEF like this:
  7822.                  -----
  7823.                  r5 n08m
  7824.                  !25
  7825.                  $fwd\n08m.rev
  7826.                  -----
  7827.        This would cause the home MSYS to keep all the traffic that you
  7828.        wanted for the acoustic system (and was listed in the N08M.REV)
  7829.        listed as PN or B$ and ready to forward into the remote system.  Make
  7830.        sure you add the pretend call to the MSYSBBSB.DAT if you will be
  7831.        forwarding bulletins.
  7832.  
  7833.  
  7834.                                 MISCELLANEOUS NOTES
  7835.  
  7836.        ON USAGE       If you have a user who ties up a RF port for hours
  7837.        reading each and every message, you may benefit by having him start
  7838.        up a MSYS check in on the phone port and get each and every message
  7839.        automatically.  In that way, the user can read the stuff off-line at
  7840.        their own computer.
  7841.  
  7842.        ON R: LINES:   The above user may then try to automatically forward
  7843.        messages out on that phone MSYS that was set up.  This will add a new
  7844.        R: line that will be unknown to your network.  You can either begin
  7845.        supporting each and every PBBS that comes and goes or demand that the
  7846.        station send their message with NO R: line and that they send their
  7847.        messages manually.
  7848.  
  7849.        REQUEST:  Please forward problems, concerns and hints to Steve,
  7850.        NO8M@NO8M.#NEOH.OH.USA.NA.
  7851.  
  7852.  
  7853.  
  7854.  
  7855.  
  7856.  
  7857.  
  7858.        MSYS 1.18                                                   Page 120
  7859.  
  7860.  
  7861.  
  7862.  
  7863.  
  7864.                                      MSYS.REP
  7865.                             CALLSIGN @ BBS REPLACEMENT
  7866.  
  7867.        This feature is used to change the routing or direction of a message.
  7868.        It can be used to redirect traffic for a certain ZIP code to a
  7869.        specific bbs that has capabilities for handling it, or it may be used
  7870.        to redirect messages from one LAN to another.
  7871.  
  7872.        Create a file called MSYS.REP.  In it place lines with the following
  7873.        format
  7874.  
  7875.        OLDCALL OLD@BBS   NEWCALL NEW@BBS
  7876.  
  7877.        For example:
  7878.  
  7879.        ALL  ALLONT   ALL  NEOH
  7880.             (messages  to: ALL@ALLONT  become ALL@NEOH)
  7881.        44* NTSOH @1 ---
  7882.             (messages to 44*@NTSOH    become originaltocall@ ---)
  7883.        NTS* * @2 @1
  7884.             (messages coming in to NTS-anything get tocall and @bbs swapped)
  7885.  
  7886.        ***  IMPORTANT  *** There can be no more than 150 lines in this file!
  7887.        The algorithm goes like this: When a message comes in, a check is
  7888.        made comparing the to call and @bbs of the message with the first two
  7889.        fields of the records in MSYS.REP.  If a match is found (wild cards
  7890.        are allowed in MSYS.REP) then the last 2 fields are used to replace
  7891.        the tocall and @bbs of the message.  @1 or @2 in the last two fields
  7892.        in MSYS.REP have a special meaning.  @1 means the original to call
  7893.        and @2 means the original @bbs.  Note that wildcards are not expanded
  7894.        in these last 2 fields.  To  support this facility a new command is
  7895.        also added: REPlace.  If an argument of L is specified, the current
  7896.        replacement list is displayed.  If no argument is given, the current
  7897.        contents of MSYS.REP are read and stored in memory.  (This is done
  7898.        when  MSYS is started also).  NOTE: You MUST use the REP command
  7899.        after you have edited MSYS.REP to make the changes effective.
  7900.  
  7901.  
  7902.  
  7903.  
  7904.  
  7905.  
  7906.  
  7907.  
  7908.  
  7909.  
  7910.  
  7911.  
  7912.  
  7913.  
  7914.  
  7915.  
  7916.  
  7917.  
  7918.  
  7919.        MSYS 1.18                                                   Page 121
  7920.  
  7921.  
  7922.  
  7923.  
  7924.  
  7925.                                    DATABASE HELP
  7926.  
  7927.  
  7928.        Commands related to Database manipulation available on MSYS
  7929.  
  7930.        MSYS allows BBS users to input information and search for information
  7931.        in simple data bases.  The names of the databases are Database.0
  7932.        through Database.999.  These files are located in the normal FILES
  7933.        directory, which can be accessed by  the D command (download) on the
  7934.        BBS.  These files can also be searched by the G command on the BBS.
  7935.        To use this command you enter the command G (with  no operands).  You
  7936.        will then be asked for the file you want to search.  Simply pressing
  7937.        return at this point will select Database.0 by default .  You are
  7938.        then asked for the search  string. This is a set of characters that
  7939.        when found in lines of the file cause those  lines to be displayed.
  7940.        Case is ignored during the search.  If a selected line ends with \
  7941.        then the following line(s) are also selected for display.  Data is
  7942.        entered into a data base by sending a message to MSYS with DBADD in
  7943.        the title.  The text of the message will be added to the indicated
  7944.        Database (Database.0) by default.  A header line is also inserted in
  7945.        the data base telling the station that made the entry,  long with the
  7946.        date and time.  Here are some examples:
  7947.  
  7948.        SP MSYS   {this is a S command issued to the BBS}
  7949.        DBADD 3   {the message title, Database.3 to be used}
  7950.        wind damage mentor Ohio \
  7951.        large tree down at 615 & 20 \
  7952.        reported by mentor pd \
  7953.        no injuries
  7954.        ^Z   {normal way to end message}
  7955.  
  7956.        The text of this message would be added to Database.3.  Now if you
  7957.        search Database 3 for either wind damage or mentor for example,  you
  7958.        would get to see these lines, along with any other lines that have
  7959.        wind damage or mentor in them.
  7960.  
  7961.  
  7962.  
  7963.  
  7964.  
  7965.  
  7966.  
  7967.  
  7968.  
  7969.  
  7970.  
  7971.  
  7972.  
  7973.  
  7974.  
  7975.  
  7976.  
  7977.  
  7978.  
  7979.  
  7980.        MSYS 1.18                                                   Page 122
  7981.  
  7982.  
  7983.  
  7984.  
  7985.  
  7986.  
  7987.        Example of using search command:
  7988.        G              {BBS command to do search}
  7989.        File search routine {Response from bbs}
  7990.        Enter file name (or just press return for Database.0): Database.3
  7991.        Enter search argument: Mentor
  7992.        {lines from message above displayed}
  7993.        >              {BBS ready for next command}
  7994.  
  7995.        Another example:
  7996.        Assume a file had the following lines:
  7997.        Mary had a little lamb
  7998.        its fleece was white as snow, \
  7999.        and every where that Mary went
  8000.        the lamb was sure to go.
  8001.        It followed her to school one day
  8002.        If you searched this for 'snow' you would get the following back:
  8003.        its fleece was white as snow, \
  8004.        and every where that Mary went
  8005.  
  8006.        That's a brief outline of what can be done.  Its simple yet very
  8007.        flexible.  Let me know of any applications you can think of for these
  8008.        facilities.  Particular Database numbers can be assigned to different
  8009.        uses.  Formats for information can be suggested for each different
  8010.        Database.
  8011.  
  8012.  
  8013.  
  8014.  
  8015.  
  8016.  
  8017.  
  8018.  
  8019.  
  8020.  
  8021.  
  8022.  
  8023.  
  8024.  
  8025.  
  8026.  
  8027.  
  8028.  
  8029.  
  8030.  
  8031.  
  8032.  
  8033.  
  8034.  
  8035.  
  8036.  
  8037.  
  8038.  
  8039.  
  8040.  
  8041.        MSYS 1.18                                                   Page 123
  8042.  
  8043.  
  8044.  
  8045.  
  8046.  
  8047.  
  8048.                          HIERARCHICAL FORWARDING and MSYS
  8049.  
  8050.  
  8051.        There are several features in MSYS that combined with hierarchical
  8052.        forwarding should almost completely automate routing of incoming
  8053.        messages.  These features act at two separate times: first when a
  8054.        message comes in and second during forwarding.
  8055.  
  8056.        First let's review the way hierarchical forwarding works.  With
  8057.        hierarchical forwarding the @BBS field can contain more than just the
  8058.        callsign of the BBS that is the DEStination of the message.  Routing
  8059.        information can also be placed in this field.  The @BBS field thus
  8060.        has the syntax of part1.part2.part3.  ....  When it is time to
  8061.        forward a message, the @BBS field is inspected and the leftmost part
  8062.        that is found in the forwarding file is used to forward the message.
  8063.        Consider as an example @N8PIH.MI.  If N8PIH is found in the
  8064.        forwarding file then it is forwarded that way and the MI part is
  8065.        ignored.  On the other hand, if N8PIH is not found in the forwarding
  8066.        file, then if MI is found in the forward file then it is forwarded
  8067.        that way.  If neither part is found in the forwarding file, then the
  8068.        message will not go anywhere.  Such messages will show up (after at
  8069.        least one forwarding attempt after the last time MSYS was started) if
  8070.        you do a L? command.
  8071.  
  8072.        If all messages had both the actual callsign of the DEStination BBS
  8073.        and the appropriate xx part in the @BBS field then the forwarding
  8074.        file could be greatly shortened.  You would need to have the calls of
  8075.        the BBS stations in your state in the forward file, along with each
  8076.        of the xx designators for the remaining states.  If there were say 50
  8077.        BBS systems in your state then perhaps 99 different entries would be
  8078.        sufficient in your forward file (ignoring for the moment bulletin
  8079.        routes like ARRL).
  8080.  
  8081.        NOTE that the limit of 400 different calls in the forward file is
  8082.        more than sufficient!  Messages that are going to a BBS in your state
  8083.        get routed as specified in your forwarding file; those going to
  8084.        another state get routed to the BBS you have set up in the forwarding
  8085.        file to get stuff for that state.  You could include a few explicit
  8086.        calls for BBS systems in nearby states that you route directly to, if
  8087.        you want to override the normal path for messages going to that state
  8088.        if you so desire.
  8089.  
  8090.        Now for the second part, the action taken by MSYS when a new message
  8091.        arrives.  When a message comes in, MSYS looks at the @BBS field.  If
  8092.        it is absent, then if the to callsign field contains something that
  8093.        MSYS knows the routing for, the to field is copied to the @BBS field.
  8094.        Otherwise the @BBS field is set to ===== and the message won't go
  8095.        anywhere.  It will show up as noted above in a L? command.
  8096.  
  8097.  
  8098.  
  8099.  
  8100.  
  8101.  
  8102.        MSYS 1.18                                                   Page 124
  8103.  
  8104.  
  8105.  
  8106.  
  8107.  
  8108.        For forwarding NTS traffic, MSYS uses a file called BBSTONTS.BIN that
  8109.        contains BBS callsigns and the states they belong in (this
  8110.        information comes from several sources, more on this later).  Next
  8111.        MSYS inspects the @BBS field to determine if it knows how to forward
  8112.        what is in the given @BBS field.  If some part of the possibly
  8113.        hierarchical specification is found in the forwarding file, it is
  8114.        left alone and will be forwarded by that matching specification.  If
  8115.        no match is found in the forwarding file, then the BBSTONTS.BIN file
  8116.        is searched to find some part of the given @BBS field.  If a match is
  8117.        found, the corresponding NTSxx is appended to the existing @BBS
  8118.        field.  Thus MSYS will attempt to lookup the right state to send the
  8119.        message to.  Assuming the state is found, then forwarding will take
  8120.        place as described above (see the N8PIH.MI example).  If no part of
  8121.        the @BBS field can be recognized, then the message will not be sent
  8122.        out, but will show up when you do a L? command as described above.
  8123.        The BBSTONTS.BIN look up will also handle zip codes given in the @BBS
  8124.        field, making @12345 into @12345.xx as is appropriate.
  8125.  
  8126.        Thus far we have examined what happens when in the process of
  8127.        automating forwarding.  In the event the proper routing cannot be
  8128.        determined by MSYS then you will have to use the Sysop EM (edit
  8129.        message) command to manually add the appropriate .xx designation,
  8130.        assuming you can guess it somehow.  If you are lucky, the originator
  8131.        put useful information in the title of the message or may have hidden
  8132.        it in the text of the message.  Maybe the callbook will be of some
  8133.        use to you.  Or maybe you can just force it in the opposite direction
  8134.        from which it arrived.
  8135.  
  8136.        IMPORTANT!  Hierarchical parsing is left to right
  8137.  
  8138.        It needs to be emphasized that MSYS will forward on the leftmost
  8139.        element matched in the @BBS ONLY.  For example, if the @BBS of a
  8140.        message is KA8Z.#NEOH.OH.USA and there is an entry in the WB8BII.REV
  8141.        file for file for KA8Z, and the path to WB8BII is lost, the message
  8142.        will NOT alternate route to the #NEOH path.
  8143.  
  8144.  
  8145.  
  8146.  
  8147.  
  8148.  
  8149.  
  8150.  
  8151.  
  8152.  
  8153.  
  8154.  
  8155.  
  8156.  
  8157.  
  8158.  
  8159.  
  8160.  
  8161.  
  8162.  
  8163.        MSYS 1.18                                                   Page 125
  8164.  
  8165.  
  8166.  
  8167.  
  8168.  
  8169.                              Bulletin Forwarding Logic
  8170.  
  8171.        New in MSYS 1.18 is the limited ability to forward bulletins based on
  8172.        hierarchical components normally used for specific bbs addressing,
  8173.        such as OH or USA.  By the proper use of the new [and ] symbols, it
  8174.        is possible to route bulletins as well as messages to specific bbs's
  8175.        based on specific portions of the given hierarchical address.
  8176.  
  8177.        1. To determine which field of the @BBS will be used to forward a
  8178.          message, the @BBS components are examined from left to right until
  8179.          a component is found in the forward file that matches. For
  8180.          purposes of comparison, xxx in the forward file will match xxx in
  8181.          any position of the @BBS, [xxx in the forward file will match only
  8182.          the leftmost component of the @BBS, and ]xxx in the forward file
  8183.          will match any component but the leftmost part of the @BBS.  Item
  8184.          7 below gives more detailed logic for determining which component
  8185.          of the @BBS is to be used for forwarding.
  8186.  
  8187.        2. A flood bulletin is a bulletin that will be forwarded on its
  8188.          leftmost component to all bbs systems in the forward file that
  8189.          contain either the leftmost component or the leftmost component
  8190.          prefixed with a [.  A non-flood bulletin is a bulletin that is
  8191.          forwarded on something other than its leftmost component in its
  8192.          @BBS field.  An example of a non-flood bulletin would be @ALLNY.NY
  8193.          when passing through the state of Ohio on its way to New York.
  8194.          Such a bulletin would be forwarded on its NY component and sent to
  8195.          only one station that handles messages going to NY.
  8196.  
  8197.        3. Each unique component found in the forward file contains an entry
  8198.          in the MSYS.BBS file. [OH, OH, and ]OH are considered to be three
  8199.          distinct components.  Components that begin with ] cannot be used
  8200.          to flood bulletins.Those components in the MSYS.BBS file that can
  8201.          be used to flood bulletins will contain a number indicating which
  8202.          BBS forwarding group(s) they appeared in, the particular numbers
  8203.          being derived from the MSYSBBSB.DAT file which gives each BBS to
  8204.          which bulletins are forwarded a unique number.  Components that
  8205.          cannot be used to flood bulletins or are only sent to BBS sytems
  8206.          that are not listed in MSYSBBSB.DAT will have zero for the number
  8207.          in the MSYS.BBS file.
  8208.  
  8209.        4. Each message has a bits field that is used to keep track of which
  8210.          BBS ssystems have which message, either because their R: line was
  8211.          inthe message when it was received or because it was forwarded to
  8212.          the BBS.  Only those BBS systems with entries in MSYSBBSB.DAT are
  8213.          recorded.
  8214.  
  8215.  
  8216.  
  8217.  
  8218.  
  8219.  
  8220.  
  8221.  
  8222.  
  8223.  
  8224.        MSYS 1.18                                                   Page 126
  8225.  
  8226.  
  8227.  
  8228.  
  8229.  
  8230.        5. At the beginning of each forward cycle, each flood bulletin is
  8231.          inspected to determine if it has been forwarded to all the systems
  8232.          that should get it.  Bulletins that have gone everywhere are
  8233.          changed fron type $ to type # which indicates they no longer need
  8234.          to be considered for forwarding and as an indication to humans
  8235.          that they have been forwarded everywhere. A flood bulletin is
  8236.          considered forwarded everywhere it should go if its bits are set
  8237.          for every BBS it should go to.  Recall that these bits are set
  8238.          when the message is first received based on the R: lines as well
  8239.          as when the emssage is forwarded.  The bits that must be sent for
  8240.          a bulletin to have been sent everywhere are the result of a logic
  8241.          OR between the bits indicated by the leftmost component of the
  8242.          message's @BBS as determined from the @BBS file and the bits
  8243.          associated with the leftmost component prefixed with [ obtained
  8244.          from the MSYS.BBS file.
  8245.  
  8246.        6. Non-flood bulletins should be marked with type F (and perhaps
  8247.          killed if autokill is on) the first time they are forwarded.
  8248.  
  8249.        7. The following logic is used to determine which component of the
  8250.          @BBS field of a message will be used for forwarding.  The first
  8251.          step that has success terminates the logic.
  8252.             MSYS.BBS is searched for
  8253.                  (a) the leftmost component
  8254.                  (b) the leftmost component prefixed with [
  8255.             For the remaining component, MSYS.BBS is searched for
  8256.                  (c) the component
  8257.                  (d) the component prefixed with ]
  8258.  
  8259.        For example, if the @BBS is X.Y.Z, MSYS.BBS would be searched for a
  8260.        match in this order:
  8261.        X
  8262.        [X
  8263.        Y
  8264.        ]Y
  8265.        Z
  8266.        ]Z
  8267.  
  8268.        In summary, if you wish to forward only flood bulletins with an @bbs
  8269.        of OH, you would have an entry of [OH in your <bbs1>.REV file.
  8270.  
  8271.        If you wish to forward messages with a hierarchical address of
  8272.        <bbs2>.OH, and not bulletins @OH, you would have an entry of ]OH in
  8273.        the <bbs3>.REV file.
  8274.  
  8275.        If you wish to forward both bulletins @OH and messages @<bbs>.OH, the
  8276.        proper entry in the <bbs4>.REV file would be:  OH
  8277.  
  8278.  
  8279.  
  8280.  
  8281.  
  8282.  
  8283.  
  8284.  
  8285.        MSYS 1.18                                                   Page 127
  8286.  
  8287.  
  8288.  
  8289.  
  8290.  
  8291.                           Creating the BBSTONTS.BIN file.
  8292.  
  8293.        This file contains binary data and cannot easily be created with a
  8294.        text editor.  Mutil function 14 takes as its input a file called
  8295.        BBSTONTS.DAT and produces as output BBSTONTS.BIN.  To create
  8296.        BBSTONTS.DAT, you run a function called BBSTONTS (function 13 in
  8297.        MUTIL) which takes as its input BBSLIST.DAT.  BBSLIST.DAT is created
  8298.        and/or updated using data from message headers that have passed
  8299.        through your system and/or AD8I BBS lists.  Function 10 of MUTIL is
  8300.        used to use messages as input; function 11 uses AD8I lists as input.
  8301.  
  8302.            Lets look at a picture of these files and programs:
  8303.  
  8304.                    +---------------+
  8305.                    | Message files |
  8306.                    | from MAIL.BAK |
  8307.                    +---------------+
  8308.                        |
  8309.                        V
  8310.                     MUTIL function 10
  8311.                        |
  8312.                     +-------------+
  8313.                     | BBSLIST.DAT |
  8314.                     |  file    |
  8315.                     +-------------+
  8316.                        |
  8317.                        |
  8318.                   MUTIL function 13  <--- Other standard files:
  8319.                        |          STATES.DAT
  8320.                        |          ZIPCODES.DAT
  8321.                        V          ROUTES.DAT
  8322.                        |
  8323.                        |
  8324.                     +-------------+
  8325.                     | BBSTONTS.DAT|
  8326.                     |   file      |
  8327.                     +-------------+
  8328.                        |
  8329.                        |
  8330.                     MUTIL function 14
  8331.                        |
  8332.                        V
  8333.                        |
  8334.                     +-------------+
  8335.                     | BBSTONTS.BIN|
  8336.                     |   file      |
  8337.                     +-------------+
  8338.  
  8339.  
  8340.  
  8341.  
  8342.  
  8343.  
  8344.  
  8345.  
  8346.        MSYS 1.18                                                   Page 128
  8347.  
  8348.  
  8349.  
  8350.  
  8351.  
  8352.                             HOUSECLEANING (HCL command)
  8353.  
  8354.  
  8355.                                      MSYS.HCL
  8356.  
  8357.        You should create a file called MSYS.HCL into which you put lines
  8358.        describing classes of messages you want to eradicate.  Each line
  8359.        should contain one or more of the following keywords:
  8360.  
  8361.        AT= TO= FROM= AGE= TITLE= TYPE= KEEP= SYSOP=
  8362.  
  8363.        So for example:
  8364.  
  8365.             AT=ARRL AGE=30
  8366.        would delete all messages with @BBS of ARRL that are over 30 days
  8367.        old.  If specified, the values of AT TO and FROM must match exactly
  8368.        for a message to be deleted.  TITLE and TYPE if specified must match
  8369.        some part of their corresponding message header fields; case is
  8370.        ignored.
  8371.  
  8372.        KEEP can be used to specify a number of msgs that match the other
  8373.        values given that should be saved anyway.
  8374.  
  8375.        Example:
  8376.  
  8377.             TO=ALL AT=ARRL TITLE=PFB KEEP=2
  8378.        Would keep the newest two messages to ALL@ARRL with PFB somewhere in
  8379.        their title.  NOTE:  The value of title given cannot contain blanks.
  8380.  
  8381.        DIR is used to specify a Directory you wish to store a message into
  8382.        before killing.  For Example:
  8383.  
  8384.             TITLE=CD-ROM age=3 DIR=FILES\HARDWARE
  8385.        Will store any file with "CD-ROM" in the title that is over 3 days
  8386.        old in the file MSYS/HARDWARE
  8387.        The title of the message will be the BID number.  This will probably
  8388.        require some Sysop editing to change the title to something more
  8389.        meaningful.
  8390.  
  8391.        SYSOP=Y has to be specified in any line that you want to delete
  8392.        messages that are to the idcall of the BBS.  Thus to delete all read
  8393.        messages (including one to you) you could have a line:
  8394.  
  8395.             TYPE=PY SYSOP=Y
  8396.  
  8397.        The following line deletes read messages, except those to you:
  8398.  
  8399.             TYPE=PY
  8400.  
  8401.  
  8402.  
  8403.  
  8404.  
  8405.  
  8406.  
  8407.        MSYS 1.18                                                   Page 129
  8408.  
  8409.  
  8410.  
  8411.  
  8412.  
  8413.        The effects of these lines can be far reaching.  For example, if you
  8414.        put in the line:
  8415.  
  8416.             KEEP=5
  8417.        Then it will delete all but the 5 newest messages!  All this action
  8418.        takes place when you type:
  8419.  
  8420.             HCLean NOW
  8421.  
  8422.        or at a time specified as a numeric parameter to HCLean.  HCL 120
  8423.        would cause it to happen at 02:00 (number given is minutes after
  8424.        00:00 [midnight] to begin housecleaning).
  8425.  
  8426.        Please note that BID= is NOT one of the items that is used to select
  8427.        messages to be killed in the MSYS.HCL file.
  8428.  
  8429.        MSYS.HCL file as an example:
  8430.  
  8431.        at=arrl age=21
  8432.        at=okipn age=10 a
  8433.        to=panet age=3 type=#
  8434.        to=mods age=3 type=# dir=files/mods
  8435.        at=alloh age=10 type=#
  8436.        at=allbbs age=7 type=#
  8437.        at=amsat age=7 title=schedule dir=files/amsat
  8438.        at=amsat age=7 type=#
  8439.        at=midnet age=3 type=#
  8440.        at=arrl title=pfb keep=1 type=#
  8441.        at=arrl title=dx keep=1 type=#
  8442.        at=arrl title=kep keep=1
  8443.        type=# title=sale age=2
  8444.        type=# title=need age=3
  8445.        type=# age=35
  8446.        type=py keep=1
  8447.        type=pf keep=2
  8448.        type=tn age=21
  8449.        type=pn age=60
  8450.        to=sysop age=7 type=#
  8451.  
  8452.        At the end of housecleaning, the file MSYSHCL.DO is done (as a DO
  8453.        file) if it exists.
  8454.  
  8455.  
  8456.  
  8457.  
  8458.  
  8459.  
  8460.  
  8461.  
  8462.  
  8463.  
  8464.  
  8465.  
  8466.  
  8467.  
  8468.        MSYS 1.18                                                   Page 130
  8469.  
  8470.  
  8471.  
  8472.  
  8473.  
  8474.                           MSYS NETWORK NODe INTRODUCTION
  8475.  
  8476.  
  8477.        Some basic information concerning the implementation of the MSYS NODe
  8478.        interface will help in making decisions related to configuration.
  8479.        Two terms must be understood by the system administrator (SYSOP).
  8480.        These terms are neighbor NODe and DEStination NODe.  A neighbor NODe
  8481.        is a compatible NODe to which there is a direct connection path.
  8482.        MSYS does not support use of digipeaters in the path to neighbor
  8483.        nodes.  Normal AX.25 connections are made to neighbor nodes.  The
  8484.        data exchanged by these connections consists of a mixture of
  8485.        supervisory and data frames that together support the network
  8486.        operation.  DEStination nodes are also network nodes and are the
  8487.        nodes listed when one does a Nodes command.  DEStination nodes are
  8488.        nodes that can be reached through the network either directly if they
  8489.        are also neighbor nodes, or indirectly through some neighbor NODe.
  8490.  
  8491.                                       Routing
  8492.  
  8493.        Routing of frames in the network is conceptually fairly simple,
  8494.        handling all the details is not!  Each NODe does a "Nodes Broadcast"
  8495.        periodically (usually every 30 minutes) which is a list of nodes that
  8496.        it knows how to route to.  This may be due to directly hearing a
  8497.        neighbor NODe or by hearing the nodes list from neighbor NODe that
  8498.        claims to have a route to each NODe it lists in its NODe broadcast.
  8499.        Information from the nodes broadcast is maintained by MSYS.  When it
  8500.        receives a frame that is not for itself, MSYS looks to see which
  8501.        neighbor NODe can handle the DEStination indicated in the frame and
  8502.        simply passes the frame on to some neighbor NODe.
  8503.  
  8504.        Data frames while they are inside the network as handled as what are
  8505.        termed "datagrams".  What this means is that during a conversation
  8506.        between two end users there is no guarantee by the network that the
  8507.        data frames will always go by the same path or that they will make it
  8508.        through the network.  Depending on conditions in the network the path
  8509.        taken by frames can change and at times frames will be arbitrarily
  8510.        discarded.  The end nodes (the ones the users connect to) are
  8511.        responsible for error free end to end services.  While the AX.25
  8512.        protocol insures that transmission of frame between any two nodes is
  8513.        error free, the network protocol establishes error free operation
  8514.        between users.
  8515.  
  8516.        MSYS network NODe functions include both the routing of frames within
  8517.        the network as well as the uplink/link logic to support the error
  8518.        free end to end services.  Additionally, the TCP/IP servers can make
  8519.        use of the network as an alternative to the existing IP routing
  8520.        facilities.  Connections from the network may be made directly to the
  8521.        BBS through the enhanced NODe command set.
  8522.  
  8523.  
  8524.  
  8525.  
  8526.  
  8527.  
  8528.  
  8529.        MSYS 1.18                                                   Page 131
  8530.  
  8531.  
  8532.  
  8533.  
  8534.  
  8535.        An attempt has been made to make the MSYS network NODe user friendly
  8536.        while still retaining compatibility with other network nodes.  To
  8537.        this end there is a help command and headings on output generated by
  8538.        various information listing commands.  Since MSYS is generally run at
  8539.        an attended site, a Talk command is available to allow users to talk
  8540.        to the Sysop directly from the network.
  8541.  
  8542.  
  8543.                       Basic Decisions About the Network NODe
  8544.  
  8545.        The really big question is should you enable the network NODe
  8546.        functions of MSYS? Fortunately, you have more options than just yes
  8547.        or no! So perhaps the question should be reworded as should you run
  8548.        the NODe in full feature, fully automated mode?  The answer for most
  8549.        stations will be NO.  The answer in your particular case will depend
  8550.        on the capabilities of your station and the locations of other
  8551.        compatible nodes.  If you run a high profile station already (wide
  8552.        coverage as a digi/K-NODe) and have compatible network nodes at
  8553.        reasonable distances from you (maybe at least 30 miles away), then
  8554.        you may fill a need by running with everything enabled.  On the other
  8555.        hand, if the only way you can talk to anything is through a
  8556.        digipeater (even when the batteries in your ht are fully charged) and
  8557.        on a hazy day you can still see the antennas of at least five network
  8558.        nodes, all still forwarding the same frame they received 2 years ago,
  8559.        then may I suggest you run in a very controlled minimal mode.  Make
  8560.        friends, not enemies through these enhancements to MSYS!
  8561.  
  8562.  
  8563.                               Network NODe Quickstart
  8564.  
  8565.        This section tells the minimal things you must do to get the NODe up
  8566.        and running in some (probably not optimal) fashion.  You MUST define
  8567.        your network NODe callsign using the NRC command.  If you are also
  8568.        active in TCP/IP you should set NRCall and MYTcpcall to be the same
  8569.        thing.  You MUST use the NPorts Command to enable the ports that you
  8570.        want to be able to access the NODe.  For example, NP 3 would allow
  8571.        access to the NODe on ports 0 and 1 but no others.  You SHOULD define
  8572.        your network NODe mnemonic identifier using the NRI command.  You
  8573.        MUST enable the NODe using the NETNode ON command.  You should
  8574.        probably turn AUTONode and AUTODESt ON and set OCM to 3.
  8575.  
  8576.        This should put your system into full service automatic mode as far
  8577.        as the network NODe is concerned.  It probably will not be the way
  8578.        you will want to run but its a starting point.
  8579.  
  8580.  
  8581.  
  8582.  
  8583.  
  8584.  
  8585.  
  8586.  
  8587.  
  8588.  
  8589.  
  8590.        MSYS 1.18                                                   Page 132
  8591.  
  8592.  
  8593.  
  8594.  
  8595.  
  8596.                   Manual Operations on the Network NODe Database
  8597.  
  8598.        To REMove a DEStination NODe completely, use
  8599.  
  8600.             REMove DEStination nodecall
  8601.  
  8602.        To REMove a DEStination for a given neighbor NODe, use
  8603.  
  8604.             DESt DELete DEStcall neighborcall
  8605.  
  8606.        To REMove a neighbor NODe (and all  the  DEStination  routes through
  8607.        this                          neighbor NODe), use:
  8608.             NODe DELete nodecall port#
  8609.  
  8610.        To add a new neighbor NODe, use
  8611.  
  8612.             NODe ADD nodecall port# quality [digicall1 .. .  digicall8]
  8613.  
  8614.        Note:  The mnemonic identifier for the neighbor NODe will be obtained
  8615.        from the first nodes broadcast heard from the NODe.
  8616.  
  8617.        Use of the digipeater calls is optional.  Although you can specify up
  8618.        to 8 digipeaters, rarely will more than 1 or 2 be practical to use.
  8619.  
  8620.        To add a new DEStination for a given neighbor NODe, use
  8621.             DESt ADD [destid:]destcall neighborcall neighborport obs#
  8622.        quality#
  8623.  
  8624.        Notes:
  8625.             The neighbor NODe callsign must be defined before any
  8626.                  DEStinations can be added for it.
  8627.             destid or alias for the DEStination is optional.
  8628.             obs# is the obsolescence count, 0 locks the DESt in for the
  8629.        NODe.
  8630.  
  8631.        To change the quality of an existing neighbor NODe, use:
  8632.             NODe REPlace callsign port# newquality [digi1 ... digi8]
  8633.  
  8634.        To change the obsolescence count and quality of a DEStination through
  8635.        some neighbor NODe, use:
  8636.             DESt REPlace DEStcall neighborcall neighborport newobs#
  8637.        newquality
  8638.  
  8639.  
  8640.  
  8641.  
  8642.  
  8643.  
  8644.  
  8645.  
  8646.  
  8647.  
  8648.  
  8649.  
  8650.  
  8651.        MSYS 1.18                                                   Page 133
  8652.  
  8653.  
  8654.  
  8655.  
  8656.  
  8657.  
  8658.                           One Possible Network NODe Setup
  8659.  
  8660.        A NETNode can be run in a moderate mode that is somewhere between
  8661.        fully automatic and low profile.  Here is some basic info that chould
  8662.        be used: Computer is an old original IBM PC 4.77 MHz clock 640 K ram,
  8663.        two 10 M hard drives, 4 serial cards and a printer card.
  8664.        Port Freq.
  8665.          0  223.7     High profile (150 W, beam at 80 ft .  aimed west)
  8666.          1  145.01    Quite high profile (200 W omni ant at 90 ft.)
  8667.          2  145.05    Low profile (10 W omni ant at 60 ft.)
  8668.          3  80 M
  8669.          4  40 M
  8670.          5  20 M
  8671.          6  serial connection to another computer
  8672.  
  8673.        Nearby existing NetRom nodes:
  8674.        Port Call           Distance
  8675.          0  WB8CQR-10      15 (Miles)
  8676.          1  WB8CQR-1       15
  8677.          1  K8EIW-1        45
  8678.          1  W8QLY          75
  8679.          1  W3LIF          80
  8680.          2  KB8AST-1       25
  8681.  
  8682.        Nearby NOS stations using NetRom interface:
  8683.        Port Call           Distance
  8684.          1  N8HSP-4        10
  8685.          1  WB8LYJ-4       15
  8686.  
  8687.        All of these stations are usually reliable connections.  Other NetRom
  8688.        nodes are usually heard but are not always reliable.  During band
  8689.        openings many more are heard, some are reliable during the band
  8690.        opening.
  8691.  
  8692.  
  8693.  
  8694.  
  8695.  
  8696.  
  8697.  
  8698.  
  8699.  
  8700.  
  8701.  
  8702.  
  8703.  
  8704.  
  8705.  
  8706.  
  8707.  
  8708.  
  8709.  
  8710.  
  8711.  
  8712.        MSYS 1.18                                                   Page 134
  8713.  
  8714.  
  8715.  
  8716.  
  8717.  
  8718.  
  8719.                            NODE RELATED PARMS in MSYS.DO
  8720.  
  8721.        Here are the network NODe related parameters I have in my MSYS.DO
  8722.        file:
  8723.        OCM 3          Transmit DESt nodes heard that have obsolescence
  8724.                       counts 3 to 6
  8725.        NRI 460406     Right 3 bytes of my IP address [44.70.4.6] expressed
  8726.                       in hex  (quite useful this way)
  8727.        NRC WA8BXN-2   Callsign net NODe responds to.  MUST be the same as
  8728.                       TCP/IP callsign (MYTcpcall)
  8729.        NPorts $47     Network NODe uses ports 0,1,2 and 6 only
  8730.        PQuality 100   Default port quality 100.  A low value assigned to
  8731.                       nodes not manually entered that connect to mine
  8732.        NODe REStore   Read saved NODe file when MSYS starts
  8733.        AUTONode OFF   Do NOT record NODe broadcasts from nodes not already
  8734.                       in neighbor lists.  This means that new nodes heard
  8735.                       (during band openings for example) will not be
  8736.                       automatically added, unless they do actually connect
  8737.                       to my NODe.
  8738.  
  8739.        AUTODESt ON    DEStination NODe broadcasts (from nodes already in
  8740.                       my neighbor table) will be recorded.
  8741.  
  8742.        NETNode ON     Enable network NODe
  8743.  
  8744.        Here is the output I get from the JN Sysop command (or R command in
  8745.        the NODe):
  8746.  
  8747.        Port Neighbor NODe Call Quality   DESts  Heard    Digipeater(s)
  8748.          1  AKR:K8EIW-1         179       66     23:43
  8749.          1  CLE1:WB8CQR-1       180       67     23:41
  8750.          0  CLE220:WB8CQR-10    180       67     23:34
  8751.          2  PRYTWP:KB8AST-1     192        2     23:25
  8752.          1  YNG:W8QLY           180        7     23:36
  8753.  
  8754.  
  8755.  
  8756.  
  8757.  
  8758.  
  8759.  
  8760.  
  8761.  
  8762.  
  8763.  
  8764.  
  8765.  
  8766.  
  8767.  
  8768.  
  8769.  
  8770.  
  8771.  
  8772.  
  8773.        MSYS 1.18                                                   Page 135
  8774.  
  8775.  
  8776.  
  8777.  
  8778.  
  8779.        The general philosophy I am using is that I only want to attempt to
  8780.        connect to network nodes that I have a good path to.  These are also
  8781.        the nodes that I broadcast myself (and the DEStinations they claim
  8782.        they can handle).  I have manually entered these nodes into my
  8783.        neighbor NODe table (using NODe ADD).  I see little sense in saying
  8784.        that I can really connect to a NODe I hear once because a meteor hit
  8785.        at the right time! This method does not particularly limit the number
  8786.        of DEStination nodes my NODe knows about because the nearby nodes
  8787.        claim they can handle everything they hear.  I just let the nearby
  8788.        nodes worry about finding routes to everything they claim to hear.
  8789.        My system serves as a link from the one isolated NODe on 145.05 LAN
  8790.        frequency to the nodes on 145.01 which give access to the Ohio 4800
  8791.        Baud UHF backbone frequency.  I also serve as an IP switch to and
  8792.        from the network.  I have adjusted the neighbor NODe qualities to
  8793.        favor nodes (primarily TCP/IP stations) to which I am a good route.
  8794.        I have set most of the normal NetRom nodes to a lower quality value
  8795.        so that they will talk directly to each other most of the time rather
  8796.        than trying to go through my NODe.  Should they be unable to connect
  8797.        directly to each other, they will still be able to go through my
  8798.        system.
  8799.  
  8800.        If you want to run very low profile in terms of getting used as a
  8801.        network NODe, leave the default of 10 set for OCMin.  This means that
  8802.        your NODe broadcasts will only send out your own call. This will get
  8803.        the network to recognize you but not make it think you are a good
  8804.        relay to anything.  Keep AUTOD ON so that your system will know how
  8805.        to reach nodes in the network.  Its probably a good idea to set AUTON
  8806.        OFF and manually add the calls of the best nearby nodes you can
  8807.        connect to (one is all you need).
  8808.  
  8809.        If you are totally confused about the network operations, try to
  8810.        consult with who ever runs your local NODe(s).  Most of the
  8811.        parameters you have, they have (with some changes in their names).
  8812.  
  8813.  
  8814.  
  8815.  
  8816.  
  8817.  
  8818.  
  8819.  
  8820.  
  8821.  
  8822.  
  8823.  
  8824.  
  8825.  
  8826.  
  8827.  
  8828.  
  8829.  
  8830.  
  8831.  
  8832.  
  8833.  
  8834.        MSYS 1.18                                                   Page 136
  8835.  
  8836.  
  8837.  
  8838.  
  8839.  
  8840.  
  8841.                       Miscellaneous Comments on Network NODe
  8842.  
  8843.        If you are low on SSIDs, you might consider the following.  Set the
  8844.        IDCALL to your callsign without any SSID.  Do not define a BBS,
  8845.        Keyboard, or K NODe callsign.  Pick an SSID and use your callsign
  8846.        with it and set as the value for MYTcpcall, NRCall and FORWARD call
  8847.        To get to your BBS the network NODe BBS command can be used.  To talk
  8848.        to your keyboard the BBS T command or network NODe T command can be
  8849.        used.  If you want to make outgoing calls you will have to define a
  8850.        keyboard callsign.
  8851.  
  8852.        Should you use the network NODe to route TCP/IP frames?  I would say
  8853.        only if you have to!  The normal IP routing is better than using the
  8854.        network NODe but in those cases where using the network is the only
  8855.        way to reach some distant IP station then do use the network.
  8856.  
  8857.        Network node connects are allowed only on those ports enabled by
  8858.        NPorts command.
  8859.  
  8860.        Kanode which lists KANodes that have been heard.  An optional
  8861.        parameter may be given that specifies the port for which the list is
  8862.        desired.
  8863.  
  8864.        Justheard which lists stations recently heard.  Here again a port
  8865.        number may be given as an argument.  The N command is now described
  8866.        as Netnodes (lists destination network nodes known).
  8867.  
  8868.        In the network node, using the C# form of the connect command
  8869.        (example: C2 WA8BXN) will always result in a normal AX.25 connect,
  8870.        even if the destination station is a network node.
  8871.  
  8872.        The network node does not record information in nodes broadcasts
  8873.        heard on ports that are not enabled for network node use (NP
  8874.        command).
  8875.  
  8876.  
  8877.  
  8878.  
  8879.  
  8880.  
  8881.  
  8882.  
  8883.  
  8884.  
  8885.  
  8886.  
  8887.  
  8888.  
  8889.  
  8890.  
  8891.  
  8892.  
  8893.  
  8894.  
  8895.        MSYS 1.18                                                   Page 137
  8896.  
  8897.  
  8898.  
  8899.  
  8900.  
  8901.                             NET NODe PARAMETERS SUMMARY
  8902.  
  8903.        (PARM          Default   Comments)
  8904.  
  8905.        PQuality [port#] # 192   Quality for nodes heard on port
  8906.        BInterval seconds 3600   Nodes Broadcast interval
  8907.        OCMin #            10    Minimum obsolescence to broadcast
  8908.        OCInit #            6    Initial obsolescence count
  8909.        WQupdate  #         1    Worst quality DESt route to record
  8910.        NTtl #             64    Network time to live (max hops)
  8911.        TTimeout seconds   60    Transport timeout (Net FRACK)
  8912.        TREtries #          3    Transport retries
  8913.        TACK sec            3    Transport ACK delay (RESPonsetime)
  8914.        TBdelay seconds   180    Transport busy delay
  8915.        NBdcast [port#]    ON    Enable or disable node broadcasts on a per
  8916.                                 port basis
  8917.        NDwindow #          4    Net default window size (frames)
  8918.        NETCon             ON    Enable connect cmd in net NODe
  8919.        NETBbs             ON    Enable BBS cmd in net NODe
  8920.        NETTalk            ON    Enable Talk cmd in net NODe
  8921.        NETXBatchsize [port] #   Sets max batch size for RLI compression on 
  8922.                                      port
  8923.        NETXOption [port#] OFF   If on, enables RLI compressed forwarding on port
  8924.        AUTODESt         OFF     Add new DESts for known neighbors
  8925.        AUTONode         OFF     Add new neighbors heard
  8926.        NODe SEnd                Force known DESt transmission
  8927.        NODe SAve                Write net NODe Database to disk
  8928.        NODe REStore             Read net NODe Database from disk
  8929.        NODe ADD call port qual [digis]    Adds neighbor NODe
  8930.        NODe REP call port qual [digis]    Changes quality of neighbor NODe
  8931.        NODe DEL call port       Deletes neighbor nodes & its DESts
  8932.        DESt ADD [id:] destcall neighbor call neighborport obs# qual
  8933.                                 Adds new DEStination
  8934.        DESt REP destcall neighborcall neighborport obs# quality
  8935.                                 Changes obs & quality
  8936.        DESt DEL destcall neighborcall neighborport
  8937.                                 Deletes DESt through given neighbor
  8938.        REMove DESt callsign     Deletes DESt through all neighbors
  8939.        NInfo                    Gives net NODe status
  8940.        NRCall callsign          Sets net NODe callsign
  8941.        NRId mnemonic            Sets net NODe mnemonic (alias) identifier
  8942.        NPorts (MASK)            Ports to which nodes broadcast are made
  8943.        TNatime seconds          Transport no activity timeout time
  8944.  
  8945.        C BBS or C bbscallsign   Acts like BBS command taking you to
  8946.                                 the bbs.  You also now get a "connected to"
  8947.                                 message with either of these commands.
  8948.  
  8949.  
  8950.  
  8951.  
  8952.  
  8953.  
  8954.  
  8955.  
  8956.        MSYS 1.18                                                   Page 138
  8957.  
  8958.  
  8959.  
  8960.  
  8961.  
  8962.  
  8963.        A number of commands allow setting options for network connections.
  8964.        Here are the network command names and their AX.25 port related
  8965.        counterpart.
  8966.  
  8967.        NETOnly        BPorts
  8968.        NETRead        MAXRead
  8969.        NETMax         BMaxcon
  8970.        NETFBBStime    FBBStimes
  8971.        NETFBBC        FBBC
  8972.        NETFBBG        FBBG
  8973.        NETXBatchsize  XBatchsize
  8974.        NETXOption     XOption
  8975.  
  8976.  
  8977.  
  8978.  
  8979.  
  8980.  
  8981.  
  8982.  
  8983.  
  8984.  
  8985.  
  8986.  
  8987.  
  8988.  
  8989.  
  8990.  
  8991.  
  8992.  
  8993.  
  8994.  
  8995.  
  8996.  
  8997.  
  8998.  
  8999.  
  9000.  
  9001.  
  9002.  
  9003.  
  9004.  
  9005.  
  9006.  
  9007.  
  9008.  
  9009.  
  9010.  
  9011.  
  9012.  
  9013.  
  9014.  
  9015.  
  9016.  
  9017.        MSYS 1.18                                                   Page 139
  9018.  
  9019.  
  9020.  
  9021.  
  9022.  
  9023.  
  9024.                                       PACTOR
  9025.                                        GTOR
  9026.                                      OVERVIEW
  9027.  
  9028.        PACTOR operates somewhat like a enhanced AMTOR.  A series of
  9029.        characters is received and an acknowledgement is sent by the
  9030.        receiving station.  PACTOR has a full character set that make it look
  9031.        like a typical packet connect.  In addition it has a number of
  9032.        features that enhance its performance such as dual speeds, internal
  9033.        compression and internal memories that enhance reception.
  9034.  
  9035.        GTOR is the KANTRONICS implementation using the Golay error
  9036.        correcting code.
  9037.  
  9038.        Neither PACTOR nor GTOR share a channel with other users.  They can
  9039.        not be used for automated forwarding.  Our own experience utilizing
  9040.        the modes while camping in very poor conditions shows that GTOR is a
  9041.        far superior mode of digital communication, with PACTOR as a close
  9042.        second choice.
  9043.  
  9044.                                      HARDWARE
  9045.  
  9046.        MSYS supports only the KAM Plus or KAMs that are upgraded to KAM Plus
  9047.        TNCs.  The KAM is the only TNC that gives separate commands to allow
  9048.        you to seize the transmit direction and to go into receiving mode.
  9049.        Other TNCs provides only toggles that lead to uncertainty about the
  9050.        state of the function being toggled.
  9051.  
  9052.        When used with MSYS, the KAM Plus can only be used as one port
  9053.        dedicated to PACTOR or GTOR.  You can not do KISS or access the VHF
  9054.        side of it.
  9055.  
  9056.        The CTS line must be present in the RS-232 cable.  The radio must be
  9057.        capable of PACTOR/GTOR operation.  Some older radios will not switch
  9058.        from transmit to receive fast enough.  (Also some newer ones
  9059.        switching between vfos or modes!)  Additional cooling will probably
  9060.        be necessary.  In addition, a larger than normal power supply may be
  9061.        necessary.  These are points which should not be overlooked.
  9062.  
  9063.        500 Hertz receive filtering is useful.  Our own experience has shown
  9064.        excellent results using minimal power into poor antennas when working
  9065.        home.  25 watts into a mobile whip is more than adequate to a home
  9066.        station running 100 watts to a dipole over a 400 mile path on 40
  9067.        meters ... 24 hours a day.
  9068.  
  9069.  
  9070.  
  9071.  
  9072.  
  9073.  
  9074.  
  9075.  
  9076.  
  9077.  
  9078.        MSYS 1.18                                                   Page 140
  9079.  
  9080.  
  9081.  
  9082.  
  9083.  
  9084.                                 PACTOR/GTOR SET UP
  9085.  
  9086.        The set up change is minimal.  The name of the port in the MSYS.OPT
  9087.        file must begin with "PACTOR" or "GTOR", depending on the mode
  9088.        desired.  For example:
  9089.  
  9090.        PACTOR_40
  9091.        or
  9092.        GTOR_HF
  9093.  
  9094.        would be appropriate.
  9095.  
  9096.                                PACTOR TNC PARAMETERS
  9097.  
  9098.        The following KAM commands must be given to set the KAM into the
  9099.        proper state:
  9100.  
  9101.        MYCALL <YOUR_CALL_HERE>  This is the callsign that will be used on
  9102.                                 the AIR.  The BBS call MAY be different!
  9103.                                 Observe your License Class privileges!
  9104.        MYPTCALL  <YOUR_CALL >   This is the call that the KAM will respond
  9105.        MYGTCALL  <YOUR_CALL >   to on the air
  9106.        CWPTT ON
  9107.        CWSPEED 20
  9108.  
  9109.        The MSYSTNC# (TNCTYPE) file for PACTOR should then contain:
  9110.  
  9111.        control-c X
  9112.        control-c d
  9113.        control-c d
  9114.        PBBS 0                   (The TNC will reset at this point)
  9115.        INTFACE TERM
  9116.        XFLOW OFF
  9117.        FLOW OFF
  9118.        CRSUP OFF
  9119.        PREKEY 0
  9120.        PTHUFF ON
  9121.        PMODE PACTOR
  9122.        DELETE 0
  9123.        SPACE 2295
  9124.        MARK 2095
  9125.        SHIFT MODEM
  9126.        ECHO OFF
  9127.        PACTOR
  9128.  
  9129.  
  9130.  
  9131.  
  9132.  
  9133.  
  9134.  
  9135.  
  9136.  
  9137.  
  9138.  
  9139.        MSYS 1.18                                                   Page 141
  9140.  
  9141.  
  9142.  
  9143.  
  9144.  
  9145.        For GTOR, the MSYSTNC# (TNCTYPE) file should contain:
  9146.  
  9147.        control-c X
  9148.        control-c d
  9149.        control-c d
  9150.        PBBS 0                   (The TNC will reset at this point)
  9151.        INTFACE TERM
  9152.        XFLOW OFF
  9153.        FLOW OFF
  9154.        CRSUP OFF
  9155.        PREKEY 0
  9156.        PTHUFF ON
  9157.        PMODE GTOR
  9158.        DELETE 0
  9159.        ECHO OFF
  9160.        GTERRS 80
  9161.        SPACE 2295
  9162.        MARK 2095
  9163.        SHIFT MODEM
  9164.        GTOR
  9165.  
  9166.  
  9167.        (The KAM Plus does not need the PERM command to remember its
  9168.        settings.)
  9169.  
  9170.  
  9171.                               PACTOR MANUAL CONNECTS
  9172.                                GTOR MANUAL CONNECTS
  9173.  
  9174.        To connect manually to another PACTOR/GTOR station, the standard
  9175.        command "C# callsign" is used.  You will not have keyboard access
  9176.        until the connect is made or fails.  The standard "^CD" is used to
  9177.        disconnect although if your connect accepts a "BYE" command or the
  9178.        like, that is preferable.  After the connect is closed, there is a
  9179.        short delay (about 10 seconds) where you again lose keyboard access.
  9180.  
  9181.  
  9182.  
  9183.  
  9184.  
  9185.  
  9186.  
  9187.  
  9188.  
  9189.  
  9190.  
  9191.  
  9192.  
  9193.  
  9194.  
  9195.  
  9196.  
  9197.  
  9198.  
  9199.  
  9200.        MSYS 1.18                                                   Page 142
  9201.  
  9202.  
  9203.  
  9204.  
  9205.  
  9206.  
  9207.                                  PACTOR FORWARDING
  9208.                                   GTOR FORWARDING
  9209.  
  9210.        Automated forwarding should not be done using PACTOR/GTOR because of
  9211.        the HF "attended" rules.  However, reverse forwarding can move
  9212.        traffic off a remote PBBS.  A MSYSFWD.DEF-like file is made with a
  9213.        filename of your choice.  This will serve as a manual forwarding
  9214.        file.  You can not have the $filename.ext type of include file.  The
  9215.        following is an example:
  9216.  
  9217.             p0 no8m
  9218.             wa8bxn
  9219.             wb8bii
  9220.             k8eiw
  9221.             -----
  9222.  
  9223.        The above causes a connect to NO8M and sends traffic for the three
  9224.        listed PBBS stations.  A reverse forward prompt then results in
  9225.        traffic for the connecting station to be reverse forwarded.
  9226.  
  9227.        The following is another example:
  9228.  
  9229.             p0 no8m
  9230.             home
  9231.             wife
  9232.             wa8bxn
  9233.             wb8bii
  9234.             k8eiw
  9235.             no8m
  9236.             oh
  9237.             usa
  9238.             -----
  9239.  
  9240.        The above file connects to NO8M from a remote version of the NO8M
  9241.        PBBS.  It sends traffic for stations who use the home NO8M to the
  9242.        HOME route.  It sends traffic for KA8ZVV to her computer which is
  9243.        attached via a RS-232 cable.  The other forwarding is standard.  When
  9244.        you wish to forward, you utilize the following command:
  9245.  
  9246.             FP filename.ext
  9247.  
  9248.        MSYS then acts on your file and forwards via the PACTOR or GTOR port.
  9249.  
  9250.  
  9251.  
  9252.  
  9253.  
  9254.  
  9255.  
  9256.  
  9257.  
  9258.  
  9259.  
  9260.  
  9261.        MSYS 1.18                                                   Page 143
  9262.  
  9263.  
  9264.  
  9265.  
  9266.  
  9267.                             USER'S VIEW WHEN CONNECTED
  9268.  
  9269.        When connected to a MSYS PACTOR/GTOR port, the user may be confused
  9270.        by the fact that the link direction is controlled by MSYS.  However,
  9271.        other than that, the user will see a port identical to a packet port.
  9272.        The user should not attempt to control the direction of the link.
  9273.  
  9274.                                 PACTOR LIMITATIONS
  9275.                                  GTOR LIMITATIONS
  9276.  
  9277.        No YAPP is currently possible on a PACTOR/GTOR port.  You also should
  9278.        not do FBB-type compressed forwarding.  No particular advantage is
  9279.        seen when using the FBB group forwarding.  DO NOT ENABLE DIGI ON THE
  9280.        PACTOR/GTOR PORT!
  9281.  
  9282.                               PACTOR TROUBLESHOOTING
  9283.                                GTOR TROUBLESHOOTING
  9284.  
  9285.        A power supply of ample capacity for your radio is necessary.  Some
  9286.        problems can be traced back to unstable or minimal power supplies.
  9287.        The use of the TERM command to go in and talk to the TNC is valuable.
  9288.        The TNC can be interrogated and connects can be established without
  9289.        regard to MSYS settings by using TERM.
  9290.  
  9291.        One initially confusing aspect is the use of "ECHO OFF".  MSYS
  9292.        requires echo to be off.  When in the TERM command mode, you may wish
  9293.        to turn echo ON so you can see what you are typing.  Before you leave
  9294.        the TERM command mode, you must remember to again set ECHO to OFF.
  9295.  
  9296.  
  9297.                                MSYS PACTOR SCANNING
  9298.                                 MSYS GTOR SCANNING
  9299.  
  9300.        By instituting scanning, your HF radio can be made to cover many more
  9301.        frequencies and, due to that, more area.  The costs are minimal.  A
  9302.        TTL-to-Serial level converter and a serial port is required.
  9303.        Although the serial port would be a lot to ask for most of us, the
  9304.        port is configured in such a way that there is no need for an
  9305.        interrupt or normal port address.  The memory required is under 1k.
  9306.  
  9307.        The port does not need an interrupt due to it never needing to read
  9308.        data.  Data is sent to the radio but there is no need to read data
  9309.        from it.
  9310.  
  9311.        It is possible to build a simple interface to allow the computer to
  9312.        choose one of four antenna lines.
  9313.  
  9314.  
  9315.  
  9316.  
  9317.  
  9318.  
  9319.  
  9320.  
  9321.  
  9322.        MSYS 1.18                                                   Page 144
  9323.  
  9324.  
  9325.  
  9326.  
  9327.  
  9328.                                      IOBUS.DOC
  9329.  
  9330.        A separate file is included with the MSYS archive that documents what
  9331.        lines on a serial card are used for what purpose.  You may want to
  9332.        review that file as it will be referred to often. It will also help
  9333.        to have documentation for the board you are using.
  9334.  
  9335.                                     INTERRUPTS
  9336.  
  9337.        You can give it a interrupt if you can spare one.  You will be
  9338.        wasting it, though, as it is not used.  If you can not spare an
  9339.        interrupt, the first thing to do is to insure that no interrupt is
  9340.        enabled on the card.  You may have to cut traces, set switches or do
  9341.        whatever you need to do to make sure the interrupt is not enabled.
  9342.  
  9343.        In most cards, you have two switches that connect either INT 3 or INT
  9344.        4 to the electronics on the card.  In some older cards, this is done
  9345.        with a jumper.  In both cases, turning the switches off or pulling
  9346.        the interrupt jumper will cause it to be disabled.
  9347.  
  9348.        There may be an instance where a interrupt is hard wired to the
  9349.        electronics.  You will need to cut that trace using a knife or a hand
  9350.        held rotary grinder.
  9351.  
  9352.                                     ADDRESSING
  9353.  
  9354.        You will need to set the address jumpers or switches to address the
  9355.        board as COM2.  This sets the address lines to the address $2f8.  By
  9356.        cutting and soldering jumpers between two of the address lines, you
  9357.        can re-address the board to be $378.  In this way, you can save the
  9358.        addressing space.
  9359.  
  9360.             This is done in this way:
  9361.  
  9362.                       $2F8     10   1111 1000
  9363.                                  \ /
  9364.                                   X      becomes
  9365.                                  / \
  9366.                       $378     11   0111 1000
  9367.                                ^            ^
  9368.                              Bit 9         Bit 0
  9369.  
  9370.        By cutting address bit 7 and address bit 6 and crossing them with a
  9371.        jumper, you have re-addressed the serial card to recognize address
  9372.        $378.
  9373.  
  9374.        You need to cut two traces, the traces that lead to finger A23 and
  9375.        A24.  Refer to the file IOBUS.DOC.  Finger A23 is soldered, via a
  9376.        jumper, to the line that used to run from A24.  A24 goes to the line
  9377.        that used to run from A23.
  9378.  
  9379.  
  9380.  
  9381.  
  9382.  
  9383.        MSYS 1.18                                                   Page 145
  9384.  
  9385.  
  9386.  
  9387.  
  9388.  
  9389.                                      DSR LINE
  9390.  
  9391.        MSYS checks a line in the serial port called the DSR line.  The DSR
  9392.        line is attached to the PTT line through level converters.  This line
  9393.        will tell MSYS when the radio has transmitted.  The radio
  9394.        transmitting will indicate that the scanning must stop.
  9395.  
  9396.        The PTT line from the KAM+ TNC is near TTL levels(0 or +5 volts).  It
  9397.        must be changed to RS-232 levels (+12 or -12 volts).  This can be
  9398.        done via a level converter.  When the TTL-to-RS-232 level converters
  9399.        are discussed, the additional wiring necessary will be covered.
  9400.  
  9401.        We determined that many RS-232 adapters, such as an adapter to take a
  9402.        9 pin plug to a 25 pin socket, are improperly wired when it comes to
  9403.        carrying the DSR line through the adapter.  If the radio does not
  9404.        stop scanning, you may want to place a RS-232 LED box, such as Radio
  9405.        Shack 276-1401, in line to verify you are seeing the DSR change.
  9406.  
  9407.                     TTL TO RS-232 INTERFACE (1488/1489 version)
  9408.  
  9409.        Supply voltages:    +5V     +12V    -12V    Ground
  9410.                             1488    14      1      7
  9411.                             1489    14             7
  9412.  
  9413.  
  9414.        RS-232 connector                                   Radio
  9415.        on computer control                                (TS-440 ACC1
  9416.        serial port:                                        connector):
  9417.                                1489        1489
  9418.        Pin 2 (XMIT DATA) -------[)o---------[)o----------> Pin 3
  9419.        (receive data)
  9420.                               1     3     4     6
  9421.  
  9422.  
  9423.                                1488
  9424.        Pin 6 (DSR)     <-------o(]--------+
  9425.                              3     2      |
  9426.                                           |  2N2222
  9427.                                        C  \
  9428.                                            \|
  9429.                                             |-----^^^^^---PTT line From TNC
  9430.                                            /| B      33K ohms
  9431.                                        E  /
  9432.                                          +
  9433.                                          |
  9434.        Pin 7 (Ground) -------------------+----------------- Pin 1
  9435.        (ground)
  9436.  
  9437.        Note:  [)o is a level converting NAND gate
  9438.             The arrow on the emitter of transistor is not shown.
  9439.             Power supply design is up to you (not much current is
  9440.                  needed).
  9441.  
  9442.  
  9443.  
  9444.        MSYS 1.18                                                   Page 146
  9445.  
  9446.  
  9447.  
  9448.  
  9449.  
  9450.                          TTL TO RS-232 INTERFACE (MAX232)
  9451.  
  9452.        The MAX232 chip allows you to do the same level changes.
  9453.  
  9454.                                     |------|
  9455.                 +12vdc ----------|--| 7805 |--|--------------|
  9456.                                  -  |------|  -              |
  9457.                               .01^            ^.01           |
  9458.                                  |            |              |
  9459.                                  |------------|              |
  9460.                                               |              |
  9461.                                              gnd             |
  9462.                                                              |
  9463.                             |------------------------|       |
  9464.                             |                        |       |
  9465.              |--------------|1                     16|-------|+
  9466.             +-              |                        |       - 10uF
  9467.         4.7uF^   gnd - )| --|2                       |       ^
  9468.              |       10uF+  |                      15|-------|
  9469.              |--------------|3                       |       |ground
  9470.                             |                        |
  9471.              |--------------|4                       |
  9472.             +-              |                        |
  9473.         4.7uF^              |                        |
  9474.              ---------------|5                       |
  9475.                             |                        |
  9476.            gnd --- | ( -----|6                       |
  9477.                  +10uF      |                        |
  9478.                             |                      10|---o(]-- PTT line
  9479.                             |                        |         from TNC
  9480.               DB-25  -------|7                       |
  9481.               pin 6         |                        |
  9482.               DB-25  -------|8                      9|---[)o--  pin 3 of
  9483.               pin 2         |                        |          ACC port
  9484.                             --------------------------
  9485.  
  9486.  
  9487.                         o(]  and  [)o  are 7400 NAND gates
  9488.  
  9489.             NOTE:  JDR (800-538-5005) is advertising a newer version
  9490.                    of the MAX232 which requires no capacitors.
  9491.  
  9492.  
  9493.  
  9494.  
  9495.  
  9496.  
  9497.  
  9498.  
  9499.  
  9500.  
  9501.  
  9502.  
  9503.  
  9504.  
  9505.        MSYS 1.18                                                   Page 147
  9506.  
  9507.  
  9508.  
  9509.  
  9510.  
  9511.  
  9512.        For ICOM and Yaesu radios, the following circuit may be used from the
  9513.        computer to the radio:
  9514.  
  9515.        RS-232 Pin 2 (XMIT DATA)                Radio Serial Input
  9516.                                                (Center of 1/8" plug for
  9517.                                                ICOM, Pin 3 of mini-DIN
  9518.                                                for Yaesu)
  9519.                            ------------------------------
  9520.            10 K Ohms      / C
  9521.                         |/
  9522.        -----^v^v^v------|   2N2222 etc
  9523.                      B  |\
  9524.                           \ E
  9525.                           |
  9526.                         Ground
  9527.  
  9528.  
  9529.  
  9530.  
  9531.  
  9532.  
  9533.  
  9534.  
  9535.  
  9536.  
  9537.  
  9538.  
  9539.  
  9540.  
  9541.  
  9542.  
  9543.  
  9544.  
  9545.  
  9546.  
  9547.  
  9548.  
  9549.  
  9550.  
  9551.  
  9552.  
  9553.  
  9554.  
  9555.  
  9556.  
  9557.  
  9558.  
  9559.  
  9560.  
  9561.  
  9562.  
  9563.  
  9564.  
  9565.  
  9566.        MSYS 1.18                                                   Page 148
  9567.  
  9568.  
  9569.  
  9570.  
  9571.  
  9572.                               SCANDEF UTILITY PROGRAM
  9573.  
  9574.        You now need to set up the files that will be necessary.  You need to
  9575.        run SCANDEF.  SCANDEF will access a ASCII file called PORTn.DEF and
  9576.        modify the scanner.  It will also define the scanning frequencies,
  9577.        the delay on each frequency before moving to another one, the antenna
  9578.        that will be used and the time that the frequency will be scanned.
  9579.  
  9580.        The "n" in PORTn.DEF is a number you supply to define the port.  If
  9581.        your port is to be number 6, you would call the file:
  9582.  
  9583.        PORT6.DEF.
  9584.  
  9585.        At least 4 lines are required in the PORTn.DEF file. In order, they
  9586.        are:
  9587.  
  9588.        TSR xx         where xx is the interrupt number of the scan TSR,
  9589.                       usually D2
  9590.  
  9591.        PORT yyy       where yyy is the hex address of the control serial
  9592.                       port
  9593.  
  9594.        SPEED zzzz     where zzzz is the baud rate of the radio's
  9595.                       computer interface
  9596.  
  9597.        freq delay antenna starthour lasthour
  9598.  
  9599.        The last line type may be repeated up to 25 times. It contains the
  9600.        frequency in MHz or KHz (14.235 or 14235 for example), the time to
  9601.        spend on this frequency listening for a connect attempt in seconds,
  9602.        the antenna number (0-3), the first hour to scan this frequency, and
  9603.        the last hour to scan this  frequency. Only the frequency is
  9604.        required. Defaults for the other values are 5 seconds, antenna 0,
  9605.        start hour 0, and last hour 23. If you give any parameter beyond
  9606.        frequency, you must specify all parameters to the left of it.
  9607.  
  9608.        Here is an example file (PORT1.DEF it might be called if port 1 is
  9609.        the PACTOR port):
  9610.  
  9611.        TSR D2
  9612.        port 378
  9613.        speed 4800
  9614.        3532.1
  9615.        3737.1  10   1  0 8
  9616.        3737.1  10   1  20 23
  9617.        7169.6
  9618.        7174.1
  9619.  
  9620.        This would scan 3632.1 and the two 40 meter frequencies all day.
  9621.        3737.1 would be scanned from 8 PM to 8 AM only, listening 10 seconds
  9622.        before going on to the next scan frequency (and using antenna 1).
  9623.        Note that these frequencies are NOT appropriate for PACTOR Operation!
  9624.  
  9625.  
  9626.  
  9627.        MSYS 1.18                                                   Page 149
  9628.  
  9629.  
  9630.  
  9631.  
  9632.  
  9633.  
  9634.                                TURNING IT ON AND OFF
  9635.  
  9636.        To enable scanning type (or better yet put in MSYS.DO) "PS n ON"
  9637.        where n is the PACTOR/GTOR port.  Repeat this for each additional
  9638.        port.  This command reads the appropriate PORTn.BIN file storing the
  9639.        frequency parameters in memory and begins scanning.
  9640.  
  9641.        To disable scanning type PS n OFF, where n again is the port number.
  9642.  
  9643.        The PS command with no operands gives basic information about PACTOR
  9644.        scanning such as which ports are enabled, current frequency and
  9645.        number of frequencies being scanned.  PS with a port number as a
  9646.        parameter gives a listing of the frequencies scanned on the given
  9647.        port.
  9648.  
  9649.        The command PS n freq will tune the radio on the given port number n
  9650.        to the specified frequency.  This frequency need not be in the scan
  9651.        list.  Using this form of the command also disables scanning.  The
  9652.        frequency can be given either in MHz (7.0991 for example) or KHz
  9653.        (7099.1).  This form of the command is useful before making a manual
  9654.        connect (using the C# command) or initiating manual PACTOR or GTOR
  9655.        forwarding (using the FP command).  Note that this command can be
  9656.        imbedded in the forward file (\ps 2 3541.2 for example). To resume
  9657.        scanning, use PS 2 ON, either manually or at the end of the forward
  9658.        file.
  9659.  
  9660.        If you have enough memory, you can run the SCANDEF program described
  9661.        below using a command like "RUN SCANDEF PORT3" while MSYS is running.
  9662.        To see the output after the program runs, type "TY $POOL".  (The RUN
  9663.        command will redirect any screen output to a file called "$POOL".
  9664.        You can read that file to determine the program's output.)  Then use
  9665.        the "PS 3 ON" command to load the new frequency specifications. This
  9666.        could all be done as a remote Sysop.
  9667.  
  9668.  
  9669.  
  9670.  
  9671.  
  9672.  
  9673.  
  9674.  
  9675.  
  9676.  
  9677.  
  9678.  
  9679.  
  9680.  
  9681.  
  9682.  
  9683.  
  9684.  
  9685.  
  9686.  
  9687.  
  9688.        MSYS 1.18                                                   Page 150
  9689.  
  9690.  
  9691.  
  9692.  
  9693.  
  9694.                                   ADDING ANTENNAS
  9695.  
  9696.        RTS and DTR outputs from the serial port are set by the antenna
  9697.        number as follows:
  9698.  
  9699.        Ant#      RTS     DTR
  9700.        ----      ---     ---
  9701.          0        0       0
  9702.          1        0       1
  9703.          2        1       0
  9704.          3        1       1
  9705.  
  9706.  
  9707.                  +V
  9708.                  |
  9709.                  |
  9710.                  |                        Transistors are 2N2222 types
  9711.                ||>                        Relays can be 12 or 5 volts
  9712.                ||> Relay A
  9713.                ||>                        You can add a manual override
  9714.                  |                        switch, LED indicators, etc.
  9715.                c |
  9716.                   \     10k
  9717.                    -----^^^^----- RTS
  9718.                   /
  9719.                e |
  9720.                  |
  9721.                  |
  9722.  
  9723.               ground
  9724.  
  9725.                  +V                                  +V
  9726.                  |                                   |
  9727.                  |                                   |
  9728.                  |                                   |
  9729.                ||>                                 ||>
  9730.                ||> Relay B                         ||>Relay C
  9731.                ||>                                 ||>
  9732.                  |                                   |
  9733.                 c|                                   |c
  9734.                   \     10k              10k        /
  9735.                    -----^^^^-------------^^^^------'
  9736.                   /               |                 \
  9737.                 e|                                   |e
  9738.                  |               DTR                 |
  9739.                  |                                   |
  9740.                  |                                   |
  9741.               ground                              ground
  9742.  
  9743.  
  9744.  
  9745.  
  9746.  
  9747.  
  9748.  
  9749.        MSYS 1.18                                                   Page 151
  9750.  
  9751.  
  9752.  
  9753.  
  9754.  
  9755.                               THE LAST STEP, THE TSR
  9756.  
  9757.        Before running MSYS, an appropriate SCANTSR program must be run, such
  9758.        as SCAN440.COM.  This is best done in your AUTOEXEC.BAT file.  The
  9759.        SCAN440.COM program is designed to be used with the Kenwood TS-440.
  9760.        Other SCANTSR programs may be found on the distribution disks,
  9761.        including programs for the ICOM IC-735 and the Yaesu FT-757.
  9762.  
  9763.  
  9764.                                 USING OTHER RADIOS
  9765.  
  9766.        As distributed it is set up for a Kenwood TS-440.  Source code is
  9767.        provided (SCANTSR.ASM) that can be modified for other radios.  If you
  9768.        do modify it for some other radio and are sure of your modifications,
  9769.        send WA8BXN a copy so that it can be included in future releases.
  9770.        The SCANTSR program is called by MSYS when it needs to tell the radio
  9771.        to go to a new frequency. It is called as an  interrupt passing the
  9772.        control serial port address in DX and the new frequency as a 32 bit
  9773.        number (long integer) in registers AX and BX.  AX has the most
  9774.        significant 16 bits.  The TSR simply formats whatever command the
  9775.        radio needs to go to the given frequency and then sends that data to
  9776.        the radio using the given control serial port address.  The control
  9777.        serial port is already initialized.
  9778.  
  9779.        EXAMPLE OF FP COMMAND FILE
  9780.        Here is my "STEVE" file so that when I want to forward to you I just
  9781.        give the command "FP STEVE":
  9782.  
  9783.        p0 no8m
  9784.        no8m
  9785.        usa
  9786.        can
  9787.        allus
  9788.        ---------
  9789.        \ps 0 on
  9790.  
  9791.        The scanner command will work only in FP files, not MSYSFWD.DEF.  To
  9792.        add a scan file, you need to put a line of dashes prior to the
  9793.        command.  The purpose of the above command is to cause scanning to
  9794.        resume at the end of forwarding.  In addition, to reverse forward to
  9795.        anyone, like KP4GE above, two things are necessary.  First, a REV
  9796.        file in the FWD directory.  Second, the callsign of the station
  9797.        connecting must appear as an entry in the MSYSFWD.DEF.  Should a
  9798.        sysop never want to forward to the station who will be reversed to, a
  9799.        dummy entry such as:
  9800.  
  9801.        -----
  9802.        P6 KP4GE
  9803.        !25
  9804.        $fwd\kp4ge.rev
  9805.        -----
  9806.  
  9807.        must appear before the station will be reversed to.
  9808.  
  9809.  
  9810.        MSYS 1.18                                                   Page 152
  9811.  
  9812.  
  9813.  
  9814.  
  9815.  
  9816.  
  9817.                              MSYS GENERAL INFORMATION
  9818.  
  9819.                                   BBS ONLY ACCESS
  9820.  
  9821.        Lets say you are running with ports 0 through 3 and want to make port
  9822.        2 bbs only access with at most 1 connection allowed at a time (either
  9823.        another BBS forwarding to you or you forwarding but not both at the
  9824.        same time).  You also don't want to generate MAIL FOR beacon on port
  9825.        2.  Use the following:
  9826.        FB 2 25           turn off mail for beacon port 2
  9827.        BP 4              port 2 bbs only
  9828.        BM 2 1            max 1 connect port 2
  9829.        MCF $B            no simultaneous forwarding on port 2
  9830.  
  9831.        Note that BP and MCF both have port masks as arguments.
  9832.  
  9833.  
  9834.                         CONNECTS FROM NON-AMATEUR CALLSIGNS
  9835.  
  9836.        Connects are no longer accepted from non-amateur callsigns  (like PK-
  9837.        232 and NOCALL for example).  You can still make connections to non-
  9838.        call signs.
  9839.  
  9840.  
  9841.                                     #  COMMAND
  9842.  
  9843.        Command lines beginning with # on the BBS are ignored (they sometimes
  9844.        come from KA Nodes).
  9845.  
  9846.  
  9847.                                   CHANNEL NUMBERS
  9848.  
  9849.        The channel numbers use a rotational assignment rather than always
  9850.        starting from 0
  9851.  
  9852.  
  9853.                                    DEVICE ERRORS
  9854.  
  9855.        Device errors are trapped by MSYS (you would previously get the
  9856.        Abort, Retry, Ignore? message).  The first occurrence of the error is
  9857.        given a response of retry, the second ignore.  This will normally be
  9858.        caught by particular function being performed which will terminate
  9859.        with an error message, but MSYS should continue operation.
  9860.  
  9861.  
  9862.                                  DISK FULL MESSAGE
  9863.  
  9864.        If the disk is full when a message is sent to the system it will give
  9865.        a message to the connection station that the disk is full and then
  9866.        disconnect.
  9867.  
  9868.  
  9869.  
  9870.  
  9871.        MSYS 1.18                                                   Page 153
  9872.  
  9873.  
  9874.  
  9875.  
  9876.  
  9877.                                         DOS
  9878.  
  9879.        If you are using MSDOS 3.3, you may need to put STACKS=0,0 in your
  9880.        config.sys file.  MSYS has been run under MSDOS 5.0 and MSDOS 6.0 as
  9881.        well as DRDOS 6.0 with no known problems or special commands other
  9882.        than FILES=40 and BUFFERS=20.  With MSDOS 5.0 and MSDOS 6.0, you may
  9883.        chose to use SMARTDRV.EXE instead of the buffers statement.  It all
  9884.        depends on your personal preference and "RAM CRAM".
  9885.  
  9886.  
  9887.                                 END OF LINE BELLS:
  9888.  
  9889.        When you type past column 72 you will get a beep for each character.
  9890.        Keep those lines less than 80 characters!
  9891.  
  9892.  
  9893.                                      EVENT.LOG
  9894.  
  9895.        In the event that a problem arises with forwarding of a message or if
  9896.        MSYS is unable to open a file, an entry is made in a file EVENT.LOG
  9897.        showing the problem and the time of occurrance.  The intent is to
  9898.        provide a clue should other strange things happen.  This file may
  9899.        generally be deleted at any time.
  9900.  
  9901.  
  9902.                                       HEADERS
  9903.  
  9904.        To create an ASCII file containing all the active message headers,
  9905.        use the following sequence of commands on the bbs:
  9906.             X 0       (turn off the More? message temporarily)
  9907.             >msghdrs  (this is the name of the file to be created)
  9908.             L$ 0      (or L 0 if you don't want to see the bids)
  9909.             >         (close the file)
  9910.             X 20      (restore the More? message)
  9911.  
  9912.  
  9913.                                      KEYBOARD
  9914.  
  9915.        When someone connects to your keyboard answer call you will get two
  9916.        musical tune to alert you to the connect.  Any stations connecting to
  9917.        your keyboard call when you are already connected to another station
  9918.        will get a busy.  The actual number of connects allowed before busy
  9919.        is given by the SYSOP command MCon.  MCon 1, for example, only allows
  9920.        an incoming call to the keyboard to be answered if there are no other
  9921.        keyboard connections.  MCon 0 prevents all incoming keyboard requests
  9922.        (they get busy).  MCon N will allow N connections to the keyboard
  9923.        until busy is returned.  When you type past column 72 you will get a
  9924.        beep for each character.  Keep those lines less than 80 characters!
  9925.        When a station attempts to connect to your keyboard via the several
  9926.        ways possible but is sent a busy the bell will also beep to alert you
  9927.        to this.
  9928.  
  9929.  
  9930.  
  9931.  
  9932.        MSYS 1.18                                                   Page 154
  9933.  
  9934.  
  9935.  
  9936.  
  9937.  
  9938.                                      ***LINKED
  9939.  
  9940.        A line of the form ***LINKED to callsign is recognized as a
  9941.        connection by the given callsign.  This occurs with some versions of
  9942.        RLI systems when a user uses the C command on the RLI system to
  9943.        connect to the MSYS BBS.  ***LINKED to callsign requires SYSOP
  9944.        verification if SYSOP call is used.
  9945.  
  9946.  
  9947.        Messages sent, forwarded, and killed get logged to MSYS.LOG.
  9948.  
  9949.        A new log file record is being generated.  It is identical to the BBS
  9950.        record except it has BYE in place of BBS.  It is generated when a
  9951.        user exits the bbs by any means (disconnect, timeout, B cmd).  You
  9952.        may wish to put an entry in the MSYSTODO.DAT file to rename MSYS.LOG
  9953.        periodically (weekly?) as the log file CAN get very large, very fast!
  9954.  
  9955.                                       LOCKUPS
  9956.  
  9957.        If the system hangs,an attempt is made to reboot.  Thus you should
  9958.        make sure you don't have a diskette in A: and that you have an
  9959.        appropriate AUTOEXEC.BAT file set up.  It is strongly recommended
  9960.        that any automatic restarts include the MUTIL 4 command to insure
  9961.        that the mail file will be properly indexed.  If the mail files are
  9962.        not properly indexed, MSYS will most likely hang on restart.
  9963.  
  9964.  
  9965.                                     MAIL BEACON
  9966.  
  9967.        Messages to your IDCALL and to SYSOP are not displayed in the MAIL
  9968.        FOR beacon.  You will see them on the screen.
  9969.  
  9970.  
  9971.  
  9972.  
  9973.  
  9974.  
  9975.  
  9976.  
  9977.  
  9978.  
  9979.  
  9980.  
  9981.  
  9982.  
  9983.  
  9984.  
  9985.  
  9986.  
  9987.  
  9988.  
  9989.  
  9990.  
  9991.  
  9992.  
  9993.        MSYS 1.18                                                   Page 155
  9994.  
  9995.  
  9996.  
  9997.  
  9998.  
  9999.                                      MAIL.BAK
  10000.  
  10001.        To reduce disk read/write delays when a message is received and
  10002.        copied to the MAIL.BAK directory, subdirectories are automatically
  10003.        created in the MAIL.BAK directory.  100 messages are backed up in
  10004.        each directory.  This can substantially reduce the time it takes to
  10005.        make the backup copy of incoming messages because much smaller number
  10006.        of file names must be looked at to add the new file name to the
  10007.        directory.  The created subdirectory names are of the form MSGxxx
  10008.        where xxx is the message number divided by 100.  Thus in MSG025
  10009.        messages 2500 to 2599 would be found.  The message /RESTore function
  10010.        from the BBS has been modified to understand these changes.
  10011.  
  10012.                               MAX channels AND PORTS
  10013.  
  10014.        Maximum for MAXCHANS is 50  (MSYS.OPT)
  10015.  
  10016.        Maximum number of ports is 7 (numbered 0 to 6)
  10017.  
  10018.        MSYS supports all IRQs (0-15) for serial ports.  I suggest the use of
  10019.        IRQs 2,3,4 & 7 on PC class computers and 3,4,5 & 7 on AT class and
  10020.        above computers.  Use of 01 & 6 are not recommended but are supported
  10021.        in the code.  Due to the use of these interrupts by other hardware
  10022.        devices/functions results will generally be bad!
  10023.  
  10024.                                  MEMORY MANAGEMENT
  10025.  
  10026.        Buffer space for logical channels is allocated when the channel is
  10027.        allocated (and released when the channel is released).  The MEM
  10028.        command may or may not change results depending on position of the
  10029.        last user in the memory space.  If you find that you are seeing
  10030.        ***MEMORY LOW BUSY messages, you probably should investigate the
  10031.        reasons why.  There are several things that you may try to do to
  10032.        relieve the problem.  The first is to use a upper memory manager to
  10033.        put as many of the TSRs as possible into upper memory.  If you use
  10034.        Quarterdeck QEMM, you should run the OPTIMIZE program.  When using
  10035.        QEMM, you may wish to NOT use DOS=HIGH in the CONFIG.SYS.
  10036.  
  10037.        Another suggestion is to use the Quarterdeck program VIDRAM with the
  10038.        "ON" switch set.  VIDRAM will utilize the memory just above the 640K
  10039.        boundary that is normally used for graphics and add it to the
  10040.        available program space.
  10041.  
  10042.  
  10043.  
  10044.  
  10045.  
  10046.  
  10047.  
  10048.  
  10049.  
  10050.  
  10051.  
  10052.  
  10053.  
  10054.        MSYS 1.18                                                   Page 156
  10055.  
  10056.  
  10057.  
  10058.  
  10059.  
  10060.        While the default MINmem is 32000, it can be lowered slightly WITH
  10061.        CAUTION.  If MINmem is set too low, you do run the risk of a user
  10062.        (INCLUDING THE SYSOP!!!) logging in and utilizing more memory
  10063.        resources than are available, causing immense grief and extra effort
  10064.        to clean up the damaged files.  A 386 system with 6 active ports and
  10065.        the SAM callsign database server using DOS 6.2, QEMM 7.05 with VIDRAM
  10066.        ON, running under DesqView 2.4 starts out with approximately 100000
  10067.        bytes free.  It seems to be enough to keep up to 14 channels working
  10068.        with very few "busys".  If that still isn't enough, you may wish to
  10069.        either try another multitasking system (Windows?) or run MSYS not
  10070.        under a multitasking system.
  10071.  
  10072.        If all that fails, or you just have a system with no expanded or
  10073.        extended memory, you need to seriously consider your MSYS
  10074.        configuration.  If you reduce the maximum number of messages (MUTIL
  10075.        1) to a smaller number, you will increase the available memory for
  10076.        users.  You may choose to limit the number of active channels.  If
  10077.        you are experiencing low memory problems, you may also wish to
  10078.        disable the conference feature.  While it is possible to reduce the
  10079.        size of the various memory stacks used by MSYS, extreme care is
  10080.        needed to avoid serious consequences.  See the section on STACKS for
  10081.        further details.
  10082.  
  10083.        Another alternative is to provide a minimum service system by running
  10084.        the "small" version of MSYS, which is distributed as MSYSB.EXE.  The
  10085.        'B' version does not provide all the fancy NODE OR TCP/IP features,
  10086.        but is will function quite nicely as a stand-alone BBS working behind
  10087.        or along side of other network switches.  Probably the major loss to
  10088.        the packet community is the fact that this version will not show up
  10089.        in a NetRom node list.  You will still need the main distribution
  10090.        disks for all of the documentation.  MSYSB.EXE is the executable
  10091.        version that replaces the "big" MSYS.EXE
  10092.  
  10093.  
  10094.                                EXPANDED MEMORY USAGE
  10095.  
  10096.        MSYS will automatically detect if either EXTENDED or EXPANDED memory
  10097.        is available.  If sufficient EXPANDED memory is present (at least
  10098.        320K must be available to be used) then all stacks will be around
  10099.        16000 bytes and come from expanded memory.  This should free up about
  10100.        50K or so of memory as shown by the MEM command.  Also each new
  10101.        connection will require less memory.  If you have expanded memory and
  10102.        don't want it used, start MSYS using: MSYS NOEMM
  10103.  
  10104.        Real expanded memory boards (that could be used with an 8086/8088
  10105.        processor) will give better performance (faster) than simulating
  10106.        expanded memory.  Expanded memory is used (if present) to contain the
  10107.        message headers.  Now you can have 2000 msgs on your system and
  10108.        memory to spare.  Be warned that with this many active msgs things
  10109.        will slow down.
  10110.  
  10111.        NOTE:  If you have problems running expanded memory try using a
  10112.        different EMM program.
  10113.  
  10114.  
  10115.        MSYS 1.18                                                   Page 157
  10116.  
  10117.  
  10118.  
  10119.  
  10120.  
  10121.  
  10122.        MSYS can also run using EXTENDED memory as well.  Of course, you will
  10123.        need to utilize a EXTENDED memory manager such as HIMEM.SYS or QEMM
  10124.        7.0 or perhaps any one of several other quality memory manager
  10125.        programs on the market.  If you have EXTENDED memory and do not want
  10126.        it used, start MSYS using:
  10127.  
  10128.        MSYS NOEXMEM
  10129.  
  10130.                              AUTOMATIC MESSAGE HOLDING
  10131.  
  10132.        If you create a file called MSYSHOLD.DAT you can specify
  10133.        characteristics of messages to hold automatically using parameters
  10134.        similar to those used in the house cleaning file.  The available
  10135.        parameters are:
  10136.        TO=       wildcard representation of To callsign
  10137.        FROM=     wildcard representation of From callsign
  10138.        AT=       wildcard representation of @BBS
  10139.        SIZE=          number that is size of message
  10140.        CONNECTED=  exact callsign of sending station (less SSID)
  10141.        PORT=     inbound port number that message is from
  10142.        BID=      This is useful for trapping known "improper" BIDs.
  10143.        TITLE=    If used, this should be the last parameter on the line.
  10144.        TEXT=     Names file which contains list of "bad words".
  10145.  
  10146.        Normally ARRL bulletins have BIDs similar to: ARLP037.  These bids
  10147.        begin with a letter.  BIDs automatically assigned to bulletins that
  10148.        don't have a bid usually begin with a digit.  So, to hold bulletins
  10149.        that probably don't have the right bid, we could use:
  10150.  
  10151.        AT=ARRL BID=#*
  10152.  
  10153.        Note that #* is a wildcard specification that matches anything that
  10154.        starts with a digit.
  10155.  
  10156.        If the value given for TITLE=  is found any where in the title of a
  10157.        message (and all other specifications are met) the message will be
  10158.        held.
  10159.  
  10160.        There is one other parameter that can be specified, a line containing
  10161.        only the letters:
  10162.  
  10163.        BBS
  10164.  
  10165.        All lines ABOVE the line BBS will look at ALL messages coming in for
  10166.        the holding criteria.  The lines below the BBS line will only apply
  10167.        to messages entered by a NON-BBS station.  For this use, a BBS is
  10168.        defined as a station that transmitted a [...$] line.  Therefore, all
  10169.        entries below the BBS line will apply to users of your system..
  10170.  
  10171.        Example:            Comment - (NOT IN MSYSHOLD.DAT FILE!)
  10172.  
  10173.        SIZE=2500           holds any messages bigger than 2500 bytes
  10174.  
  10175.  
  10176.        MSYS 1.18                                                   Page 158
  10177.  
  10178.  
  10179.  
  10180.  
  10181.  
  10182.        FROM=WA8BXN PORT=2  holds messages from WA8BXN that come in on port 2
  10183.        CONNECTED=W8XYZ     holds all messages sent by connected user station
  10184.                            W8XYZ
  10185.        AT=MSYS             holds all messages with @MSYS
  10186.        TEXT=BADWORDS.DAT   holds all messages that have any words found in
  10187.        BADWORDS.DAT file.
  10188.        BBS
  10189.        AT=ALL*
  10190.  
  10191.        Note: the difference between FROM= and CONNECTED=
  10192.        FROM is the from call for the message (often supplied after < in the
  10193.        S  command), while
  10194.        CONNECTED is the call of the station connected to the bbs sending the
  10195.        message.
  10196.  
  10197.        In the above example, a message sent to ALLUS from a local USER would
  10198.        be held, but would NOT be held if entered from a connected BBS.
  10199.  
  10200.        NOTE:  Held messages are visible only to the SYSOP  They are killable
  10201.        only by SYSOP.  A message will be sent to a user (not a BBS) that the
  10202.        message has been held and made invisible for SYSOP review.  The user,
  10203.        at that point, has no further ability to deal with that message.
  10204.  
  10205.        Other options on the lines in MSYSHOLD.DAT:
  10206.  
  10207.        * at the beginning of the line makes it into a comment
  10208.  
  10209.        TEXT=filename operand
  10210.        When specified, if other tests are met, the text and title of the
  10211.        message will be compared with the contents of the given filename .
  10212.        If any of the words in the file match, the message will be held.
  10213.        Case is ignored in the test.
  10214.  
  10215.        Example:
  10216.  
  10217.        TO=ALL TEXT=WORDLIST.1
  10218.  
  10219.        would cause all messages going to ALL  to be compared with the file
  10220.        WORDLIST.1.  Put one phrase or word per line in the file, enclosed in
  10221.        either single or double quote marks.  You may also put a number
  10222.        between 1 and 255 at the beginning of the line before the quoted
  10223.        phrase to assign a weight to the word.  If no weight is given, the
  10224.        word or phrase gets a weight of 255.  Here is a sample file of words:
  10225.  
  10226.        'war'
  10227.        "900"
  10228.        "send check"
  10229.        50 'send'
  10230.        50 "check"
  10231.        "That's it"
  10232.  
  10233.  
  10234.  
  10235.  
  10236.  
  10237.        MSYS 1.18                                                   Page 159
  10238.  
  10239.  
  10240.  
  10241.  
  10242.  
  10243.        If the sum of the weights of these "words" found in the title or
  10244.        message text exceeds HOLdlevel (default 0) then the message is held.
  10245.        NOTE: HOLdlevel is a new SYSOP command!
  10246.  
  10247.        CAUTION: 'war'  would match an occurrence in the word 'forWARd' in a
  10248.        message.  Its not a real problem as it just means the message will be
  10249.        held not killed off.
  10250.  
  10251.        To resolve that "problem", you may include a space either before, or
  10252.        after or both before and after to "isolate" the specific word you
  10253.        wish to hold. A space will also help catch words at the beginning or
  10254.        end of a sentence.  For example, if our "bad" word is "dirt", the
  10255.        following:
  10256.        " dirt " in wordlist.1 will catch the word "dirt" but not the word
  10257.        "dirty" in the sentence: The dirty bird's name is dirt.
  10258.  
  10259.  
  10260.        If the word KILL is added to the line in MSYSHOLD.DAT, the message
  10261.        will be stored in the mail.bak directory and immediately killed.  For
  10262.        example:
  10263.  
  10264.        TO=DIRT KILL
  10265.  
  10266.        will kill all messages to DIRT.  It is suggested that this form of
  10267.        the command be used with care.  The KILL option does NOT work with
  10268.        the TITLE= option.
  10269.  
  10270.  
  10271.                                       MSYS.DO
  10272.  
  10273.        MSYS.DO is a file which you should create to do all of the SYSOP
  10274.        commands needed to prepare your specific MSYS system.  This file is
  10275.        processed as a series of commands and is far easier to do rather than
  10276.        manually typing them every time you start MSYS.  When the system
  10277.        starts, it automatically tries to do a DO command.  See the sample
  10278.        file for more information on the possible contents.
  10279.  
  10280.  
  10281.                                    MSYSTODO.DAT
  10282.  
  10283.        Timed execution of commands can be done in MSYS.  You can create  a
  10284.        file called MSYSTODO.DAT with commands and times they should be done.
  10285.        Wild cards can be specified for the times.  Each line consists of a
  10286.        time (given as exactly 8 characters)  followed by  a space, and then
  10287.        the command to execute at the  given  time. The wildcard character is
  10288.        ? and they may only occupy positions in the  left  part of the time .
  10289.        The format of the time  is  MMDDhhmm where  MM  is the month number
  10290.        (1 to 12), DD is the  day  of  the month  (1 to at most 31), hh is
  10291.        the hour (0 to 23) and mm is  the minute (0 to 59) .  Here are some
  10292.        time examples:
  10293.  
  10294.        MMDDhhmm (pattern)
  10295.        ???????? every minute
  10296.  
  10297.  
  10298.        MSYS 1.18                                                   Page 160
  10299.  
  10300.  
  10301.  
  10302.  
  10303.  
  10304.        ???????0  every 10 minutes (times that are like 00 10 20 etc.  for
  10305.                  the minutes)
  10306.        ??????00 at the beginning of every hour
  10307.        ????1200 at noon every day
  10308.        ????0000 at midnight every day
  10309.        ???10000 at midnight of the 1st, 11th and 21st days of each month
  10310.        ??010400 at 4 am the first of every month
  10311.        01010000 at the beginning of every year
  10312.  
  10313.        You can also specify a day of the week in the DD field, in  place of
  10314.        the day of the month .  To do this you would put D# in  the  DD field
  10315.        (# is from 1 to 7 for Sunday to Saturday) .  Examples:
  10316.  
  10317.        ??D11200 Every Sunday at noon
  10318.        11D52300 At 11 PM on each Thursday in November
  10319.  
  10320.        That is how the times are set up, now here is a complete  example
  10321.        of things that could go in MSYSTODO.DAT:
  10322.  
  10323.        ????0000 nod sav
  10324.        ????1200 nod sav
  10325.        ??010000 log
  10326.        ??d10000 copy msys.usr msysusr.bak
  10327.        ???????0 dt
  10328.  
  10329.        This file would save the network node list twice a day, make a new
  10330.        log file at the beginning of every month, make a backup of the user
  10331.        file every Sunday, and display the time and date every 10 minutes.
  10332.  
  10333.  
  10334.                                      MSYSTNC.#
  10335.  
  10336.        If you use any TNC set up files be warned that the program waits 1
  10337.        sec after each line from the file is sent to the TNC to give it time
  10338.        to think about it.
  10339.  
  10340.        NOTE:
  10341.        AEA TNCs made after Jan. 89 can probably be treated like KPC-x TNCs
  10342.        to get them into kiss mode.  It should no longer be necessary to have
  10343.        a special TNC file for them (but if it doesn't work without it, it is
  10344.        suggested that the TNC file be used).  A good solution to the TNC to
  10345.        kiss problem with MFJ 1270/4 TNC-2 compatibles is to install the
  10346.        JKISS EPROM available from Tucson Amateur Packet Radio.  The EPROM
  10347.        forces the TNC to ALWAYS be in the KISS mode, and no further action
  10348.        by MSYS (MSYSTNC.# file) is needed.
  10349.  
  10350.  
  10351.  
  10352.  
  10353.  
  10354.  
  10355.  
  10356.  
  10357.  
  10358.  
  10359.        MSYS 1.18                                                   Page 161
  10360.  
  10361.  
  10362.  
  10363.  
  10364.  
  10365.                               Special KISS Parameters
  10366.  
  10367.        There are 4 parameters that may be set either before the TNC is put
  10368.        into the KISS mode with the MSYSTNC.x or after by commands from the
  10369.        MSYS.DO file.
  10370.  
  10371.        They are:
  10372.  
  10373.        TXD
  10374.        TXT
  10375.        PPersist
  10376.        SLottime
  10377.  
  10378.        It is probably best to set them in the MSYS.DO file so that you have
  10379.        the ability to determine what the value is in your TNC by examining
  10380.        the parameter from the keyboard.  If MSYS has NOT set the parameter
  10381.        after the TNC has gone into the KISS mode, it will show -1 as the
  10382.        value.
  10383.  
  10384.        Suggested values are TXD 30, TXT 5, PPersist 64, SLottime 10.
  10385.        Your mileage may vary.
  10386.  
  10387.                                     Packet size
  10388.  
  10389.        Data in packets is limited to 256 bytes.  Larger amounts of data in a
  10390.        single packet will be discarded without causing the system to crash.
  10391.  
  10392.  
  10393.  
  10394.  
  10395.  
  10396.  
  10397.  
  10398.  
  10399.  
  10400.  
  10401.  
  10402.  
  10403.  
  10404.  
  10405.  
  10406.  
  10407.  
  10408.  
  10409.  
  10410.  
  10411.  
  10412.  
  10413.  
  10414.  
  10415.  
  10416.  
  10417.  
  10418.  
  10419.  
  10420.        MSYS 1.18                                                   Page 162
  10421.  
  10422.  
  10423.  
  10424.  
  10425.  
  10426.                                      PASSWORDS
  10427.  
  10428.        There are several PASSWORD types utilized in MSYS.
  10429.  
  10430.                                    REMOTE SYSOP
  10431.  
  10432.        First, there is the remote SYSOP password.  The phrase for this is
  10433.        stored in a file called MSYS.RMT in the C:\MSYS directory. to you.
  10434.  
  10435.        /Sysop command:  CASE SENSITIVE!
  10436.  
  10437.        This command gets you into remote SYSOP mode which allows you to use
  10438.        most of the SYSOP commands through the bbs.  The command must be
  10439.        typed exactly as shown: backslash, Capital S and lower case ysop and
  10440.        then return.  You will then get a line like
  10441.  
  10442.        Usage stats: Users=4 Msgs rcvd=10 Msgs sent=5 Max=8
  10443.  
  10444.        You MUST respond with the EXACT characters needed before SYSOP
  10445.        privileges will be granted.  To this you must reply (there will be no
  10446.        prompt) with the four characters corresponding to the numbers typed
  10447.        in order of characters found in the file MSYS.RMT (case is
  10448.        important).  For example, if your MSYS.RMT file contained MSYS is the
  10449.        greatest! then you would type <space> e i t which are the
  10450.        corresponding characters (the first character is numbered 0).  Thus
  10451.        you would type: eit (Don't forget to count the spaces) You should now
  10452.        get a prompt cmd:  If you are connected via radio, you issue /Sysop
  10453.        command on bbs to verify SYSOP authority (enter 4 letters) You then
  10454.        get the next bbs prompt (if you give correct letters or not).  If you
  10455.        have given the correct reply then you may issue any SYSOP command by
  10456.        starting the line with \ (while still in the bbs).  So when on the
  10457.        bbs from the local keyboard, you can now type something like \em 1234
  10458.        and you will be able to edit message 1234 without having to leave the
  10459.        bbs.  As a remote SYSOP, once you give the right 4 letters, you
  10460.        retain SYSOP status until you disconnect.  To get a list of available
  10461.        commands, type h.  Most of the commands available duplicate those
  10462.        found normally as SYSOP commands.  An added command, WHO, gives a
  10463.        list of who is on the system and is the same as the new U command in
  10464.        the bbs.
  10465.  
  10466.        NOTE: /Sysop is not required from local keyboard.
  10467.        Make sure you mark yourself a remote SYSOP, even if you won't be
  10468.        one.(User flag $10)
  10469.  
  10470.  
  10471.  
  10472.  
  10473.  
  10474.  
  10475.  
  10476.  
  10477.  
  10478.  
  10479.  
  10480.  
  10481.        MSYS 1.18                                                   Page 163
  10482.  
  10483.  
  10484.  
  10485.  
  10486.  
  10487.                              AUTOMATIC PASSWORD REPLY
  10488.  
  10489.        If you are running a remoted MSYS system (you DO go on vacation,
  10490.        don't you?), you may automate that return process by having a file
  10491.        called PASSWORD.RMT in your C:\MSYS\FWD directory.  Likewise, this is
  10492.        a convenient way for your neighbor SYSOP to manage your system while
  10493.        you are absent.
  10494.  
  10495.        If your system receives the password prompt (the "Usage    stats"
  10496.        line) from a system that you connected to during forwarding or from
  10497.        the Connect commands,  MSYS will automatically supply the correct
  10498.        response.  You must have a file with the <callsign>.RMT in your FWD
  10499.        directory that is the same as the MSYS.RMT file on the other system.
  10500.        If you were to automatically sysop the WB8BII system, you must have a
  10501.        c:\msys\fwd\wb8bii.rmt file that is identical to the C:\MSYS\MSYS.RMT
  10502.        file on WB8BII.  You may have several c:\msys\fwd\<call>.RMT files to
  10503.        enable you to sysop several systems.
  10504.  
  10505.        NOTE:  If you are using MSYS to remote SYSOP a distant bbs, it will
  10506.        respond ONLY ONCE per initial connect!  For example, if you are using
  10507.        MSYS to SYSOP a remote system from the campground,  your local system
  10508.        will respond to the "Usage..." statement the first time.  If you
  10509.        disconnect from the remote bbs and drop back to a node, then
  10510.        reconnect to the remote system, your local MSYS will NOT respond to
  10511.        the "Usage..." statement.  You must disconnect completely and then
  10512.        re-establish the connection to the remote system for the automatic
  10513.        password response to be given.  This is done to help prevent repeated
  10514.        automatic attempts to decipher the password.
  10515.  
  10516.  
  10517.                                   USER PASSWORDS
  10518.  
  10519.        A third form of password protection is the USER password.  If the
  10520.        bits for USER password have been set for a user, then you must have a
  10521.        PASSWORD DIRECTORY.  The directory will contain a file for each user
  10522.        with ONLY the callsign as the file name.  There are NO SSID's or
  10523.        extensions used.  The sample directory and file name would look like
  10524.        this:
  10525.  
  10526.        C:\MSYS\PASSWORD\N8UDK
  10527.  
  10528.        At a minimum, N8UDK's user bits would be set to $400.
  10529.  
  10530.        If a user has their flag bits set with the $400 bit on, when they
  10531.        connect they will get the Usage stats message line and must give the
  10532.        proper 4 characters just like a SYSOP would.  The password file for a
  10533.        user must be in the PASSWORD directory and has a filename of the
  10534.        user's call (no SSID, no file extension).
  10535.  
  10536.        A fourth password is the one used by the FTP function of TCP/IP.  It
  10537.        is more fully described under the heading of MSYSPASS.DAT.
  10538.  
  10539.  
  10540.  
  10541.  
  10542.        MSYS 1.18                                                   Page 164
  10543.  
  10544.  
  10545.  
  10546.  
  10547.  
  10548.        A fifth password file that is should be used is the MSYSPASS.IP.
  10549.        This file lists the call and password and callsign for Telnet users.
  10550.        If this file is not present when a station makes a Telnet connect to
  10551.        the bbs, rather than asking for login and password, it will simply
  10552.        ask for callsign which will be used without further verification.
  10553.  
  10554.        A sixth password file is utilized for modem access.  Discussion of
  10555.        the modem passwords used in the MSYSPASS.MOD file can be found in the
  10556.        documentation in the MODEM section.
  10557.  
  10558.  
  10559.  
  10560.                         TheNet & NetRom RS-232 Connections
  10561.  
  10562.        RS-232 Connections of ports to TNCs running NetRom and TheNet should
  10563.        use > as the first character in the name given in the port statement
  10564.        in MSYS.OPT.
  10565.  
  10566.        To connect the computer to a single TNC per computer port, a straight
  10567.        through cable is used (with a minimum of pins 2,3 and 7).  At the TNC
  10568.        end, pins 10 and 23 must be jumpered.  DO NOT CONNECT PINS 10 or 23
  10569.        at the computer end!  In a NetRom/TheNet equipped TNC, the connection
  10570.        between pins 10 and 23 switches the TNC interface from a normal ASCII
  10571.        terminal interface to one that sends NetRom Serial protocol.
  10572.  
  10573.        In a multiple TNC connection using the standard diode matrix
  10574.        interconnect,  the computer may be connected if you reverse pins 2&3
  10575.        and pins 5&20 at the computer connection.
  10576.  
  10577.        Using MSYS into a matrix with NetRom or TheNet equipped TNCs can have
  10578.        great advantages on a backbone system.  The TNCs handle traffic on
  10579.        the backbone not going to/from the MSYS system without any load being
  10580.        placed on the MSYS computer.  MSYS then gains the advantage of a fast
  10581.        reliable connection to the adjacent nodes.
  10582.  
  10583.        Forwarding may be accomplished by connecting to the RS-232 connected
  10584.        TNC or matrix using normal script files.  When using the NetRom
  10585.        Serial protocol, remember the ">" character in the port statement!
  10586.  
  10587.  
  10588.                                        SMTP
  10589.  
  10590.        The \+\filename include capability that is currently in the BBS S
  10591.        command is also usable in SMTP with the PRompt command.  Both of
  10592.        these are available only from the local keyboard.
  10593.  
  10594.  
  10595.        Typing other than Y N C A or RETURN in response to More? in the BBS
  10596.        is taken as a new command.
  10597.  
  10598.  
  10599.  
  10600.  
  10601.  
  10602.  
  10603.        MSYS 1.18                                                   Page 165
  10604.  
  10605.  
  10606.  
  10607.  
  10608.  
  10609.                                  STACK Requirement
  10610.  
  10611.          NOTE: NOT USED WITH EXPANDED OR EXTENDED MEMORY!
  10612.  
  10613.        The stack space needed by the forward process has increased.  The
  10614.        following line can be put in MSYS.OPT  (This may not be necessary):
  10615.  
  10616.        STACK FORWARD 8000
  10617.  
  10618.        A smaller value (maybe 7000) might work.  Try it if you want.  If the
  10619.        system randomly crashed, make it 8000.
  10620.  
  10621.  
  10622.                                        TERM
  10623.  
  10624.        TERM is Sysop command which allows the Sysop to directly access the
  10625.        hardware connected to a port.  It is extremely limited in what it can
  10626.        do.  It is designed to allow you to interrogate and test port
  10627.        hardware.
  10628.  
  10629.        The syntax for this command is:
  10630.  
  10631.        TERM #
  10632.  
  10633.        where "#" is the port number.  TERM permits direct keyboard access to
  10634.        the port for issuing commands to a modem or perhaps a TNC.  The
  10635.        screen will show what is received from the hardware.  The keyboard
  10636.        input will be sent to the hardware.
  10637.  
  10638.        The F9 key will take most TNCs out of the KISS mode so that you may
  10639.        communicate with the TNC command processor.  DON'T FORGET TO PUT THE
  10640.        TNC BACK INTO THE KISS MODE BEFORE EXITING!  In a similar fashion,
  10641.        when accessing the PACTOR/GTOR port, the same rule applies - leave
  10642.        the TNC in the proper mode (<PACTOR STANDBY>/<GTOR STANDBY >) before
  10643.        exiting.  The term mode can also be used to access the modem,
  10644.        however, none of the MSYS capture or include features are available.
  10645.        To properly exit the dumb terminal mode, depress the F10 key.
  10646.  
  10647.        "F9" can be used to take a TNC out of the KISS mode.
  10648.  
  10649.        When used with a KISS TNC, not much be accomplished.  The TNC can be
  10650.        taken out of KISS mode, adjusted and reset to KISS but automated
  10651.        events within the system may lead to undesired and unpredictable
  10652.        results.  There is no recording, sending of files, etc. and there is
  10653.        no plan to add them.
  10654.  
  10655.        "F10" will end the TERM session.
  10656.  
  10657.  
  10658.                                       TESTING
  10659.  
  10660.        You can connect two MSYS systems together through their serial ports
  10661.        by the use of a NULL MODEM.
  10662.  
  10663.  
  10664.        MSYS 1.18                                                   Page 166
  10665.  
  10666.  
  10667.  
  10668.  
  10669.  
  10670.  
  10671.        You can also connect a loopback by connecting pins 2 and 3 on the
  10672.        same serial port.  This will allow you to see what the system is
  10673.        doing without being on the air.
  10674.  
  10675.  
  10676.  
  10677.                                  TITLES TRUNCATED
  10678.  
  10679.        Titles of messages are truncated after 37 characters.
  10680.  
  10681.  
  10682.                                   TYPE OF MESSAGE
  10683.                                  (the "TR" field)
  10684.  
  10685.        The algorithm uses 3 pieces of information to determine the
  10686.        appropriate TR to assign: the destination "callsign", the @"bbs", and
  10687.        the character after the S in the Send command.
  10688.  
  10689.        The to ."callsign" is classified as one of the following:
  10690.             0 - Looks like a real callsign
  10691.             1 - A zipcode (5 digits)
  10692.             2 - something else (like ALL, for example)
  10693.  
  10694.        The @"bbs" is classified as one of the following:
  10695.             0 - Looks like a real callsign
  10696.             1 - none specified
  10697.             2 - call of this bbs
  10698.             3 - something else
  10699.  
  10700.        The character after the S in the s command is classified as:
  10701.             0 - B  (as in SB for send bulletin)
  10702.             1 - P  (as in SP for send private)
  10703.             2 - T  (as in ST for send traffic)
  10704.             3 - none (as in just plain S)
  10705.             4 - something else (SW for send weather bulletin, for example)
  10706.  
  10707.        The following message types are generated:
  10708.             BN   For  bulletins going to a specific bbs - these are
  10709.                  forwarded to a single station that handles that bbs.
  10710.             PN  For private messages
  10711.             TN  For NTS traffic
  10712.             xN  For Sx where x is an "something else"
  10713.             N   For individual non-private messages.
  10714.             B$  For bulletins going with @route (like ARRL)
  10715.             x$  For bulletins sent with Sx (x is "something else")
  10716.             P$  For private bulletins going with @route
  10717.  
  10718.        Note: [P]N below means that the type will be N is MAKEPrivate is off,
  10719.        PN if MAKEPivate is ON (default).
  10720.  
  10721.                     TR Values Assigned to Messages
  10722.  
  10723.  
  10724.  
  10725.        MSYS 1.18                                                   Page 167
  10726.  
  10727.  
  10728.  
  10729.  
  10730.  
  10731.        For messages going to Callsigns:
  10732.  
  10733.        Character after S ->     B    P    T    None x (Other)
  10734.        @BBS type:               ---  ---  ---  ---- ---------
  10735.        callsign                 BN   PN   TN   [P]N xN
  10736.        no bbs given             B$   PN   TN   [P]N x$
  10737.        this bbs                 B$   PN   TN   [P]N x$
  10738.        something else           B$   PN   TN   [P]N x$
  10739.  
  10740.        For messages going to ZIP Codes:
  10741.  
  10742.        Character after S ->     B    P    T    None x (Other)
  10743.        @BBS type:               ---  ---  ---  ---- ---------
  10744.        callsign                 BN   PN   TN   TN   xN
  10745.        no bbs given             B$   P$   TN   TN   x$
  10746.        this bbs                 B$   P$   TN   TN   x$
  10747.        something else           B$   P$   TN   TN   x$
  10748.  
  10749.  
  10750.        For messages going to SOMETHING ELSE:
  10751.  
  10752.        Character after S ->     B    P    T    None x (Other)
  10753.        @BBS type:               ---  ---  ---  ---- ---------
  10754.        callsign                 BN   PN   TN   BN   xN
  10755.        no bbs given             B$   P$   TN   B$   x$
  10756.        this bbs                 B$   BN   TN   B$   x$
  10757.        something else           B$   P$   TN   B$   x$
  10758.  
  10759.        Messages with second character of type N are forwarded to one place
  10760.        (and then killed if AUTOKill is ON, the N is changed to F otherwise).
  10761.        Messages with second character of type $ are flooded to all stations
  10762.        that get the specified @BBS.  When sent to all such BBSs, the second
  10763.        character gets changed to #.
  10764.  
  10765.        Messages that come in with an R: line that contains the call
  10766.        (actually HCAll) of this bbs are automatically held.  The R: line
  10767.        scan is terminated by the first non-R: line found in the message.
  10768.  
  10769.  
  10770.  
  10771.  
  10772.  
  10773.  
  10774.  
  10775.  
  10776.  
  10777.  
  10778.  
  10779.  
  10780.  
  10781.  
  10782.  
  10783.  
  10784.  
  10785.  
  10786.        MSYS 1.18                                                   Page 168
  10787.  
  10788.  
  10789.  
  10790.  
  10791.  
  10792.        Bulletins that arrive with a bid on the S command line are rejected
  10793.        if their BID already exists in the BID file.  Bulletins are
  10794.        identified as those messages that arrived via the SB command or S
  10795.        non-call.  All messages other than bulletins are always received
  10796.        (never rejected).  If  a message identifier ($string) exists on the S
  10797.        command line it is used.  In all other cases, a message identifier is
  10798.        generated internally for all non-bulletins using the bbs call and
  10799.        message number from the last R: line scanned.  If the message
  10800.        identifier is found in the BID file and the message was not held
  10801.        because of this systems R: line, the message is not saved (but it is
  10802.        acknowledged as being received entirely by sending the > prompt when
  10803.        the ^Z is received).  The processing of internal message identifiers
  10804.        is not indicated in the system identification line [MSYS-XXXX-H$].
  10805.        If you set MIDchar to something, then the character will appear
  10806.        between the H and the $.  For example, if you set MIDchar to M, then
  10807.        the SID line will be [MSYS-XXXX-HM$].  This will be sent to all
  10808.        stations that connect to the BBS.  Setting MIDchar to a non-null
  10809.        character will also cause  the MID to be sent during forwarding if
  10810.        the system to which you are forwarding has MIDchar in its SID.
  10811.  
  10812.  
  10813.  
  10814.  
  10815.  
  10816.  
  10817.  
  10818.  
  10819.  
  10820.  
  10821.  
  10822.  
  10823.  
  10824.  
  10825.  
  10826.  
  10827.  
  10828.  
  10829.  
  10830.  
  10831.  
  10832.  
  10833.  
  10834.  
  10835.  
  10836.  
  10837.  
  10838.  
  10839.  
  10840.  
  10841.  
  10842.  
  10843.  
  10844.  
  10845.  
  10846.  
  10847.        MSYS 1.18                                                   Page 169
  10848.  
  10849.  
  10850.  
  10851.  
  10852.  
  10853.        Here are some combinations of the parameters to do selected
  10854.        processing:
  10855.  
  10856.        For no BID (mid) processing on non-bulletins, set
  10857.             BIDall OFF
  10858.  
  10859.        To emulate AA4RE MID processing (I think), set
  10860.             BIDallON
  10861.             MIDchar M
  10862.  
  10863.        To use a MID if provided, or generate one otherwise, set
  10864.             BIDall ON
  10865.             ACceptmid ON
  10866.             MIDchar M
  10867.  
  10868.        Currently there is still a lot of discussion going on over  MIDS.
  10869.        Hopefully I have give enough parameters so that MSYS can be used with
  10870.        whatever standard wins out.
  10871.  
  10872.  
  10873.                                 USER BIT SETTINGS:
  10874.  
  10875.        $01   -  Expert user
  10876.        $02   -  BBS
  10877.        $04   -  Bad User Bit  (Disconnect immediately)
  10878.        $08   -  Limited BBS  Permits only limited use of the bbs
  10879.        $10   -  Remote SYSOP status
  10880.        $20   -  Need to send WP Update
  10881.        $40   -  Multiline packets (XF)
  10882.        $80   -  Prevents use of the S command.  Users so marked can only
  10883.                  read messages.
  10884.        $100  -  Lock user
  10885.        $200  -  Authorizes use of the Upload command in the bbs.
  10886.        $400  -  Must have user password
  10887.        $800  -  YAPP Upload authorized
  10888.        $1000 -  Auto Reply turned on
  10889.        $2000 -  No Automatic LC in BBS
  10890.        $4000 -  No "You have unread mail" message
  10891.        $8000 -  New User flag
  10892.  
  10893.        NOTE: These settings may be added together.
  10894.  
  10895.        CAUTION!  They ADD in HEXADECIMAL!  800 + 200 = A00
  10896.  
  10897.  
  10898.  
  10899.  
  10900.  
  10901.  
  10902.  
  10903.  
  10904.  
  10905.  
  10906.  
  10907.  
  10908.        MSYS 1.18                                                   Page 170
  10909.  
  10910.  
  10911.  
  10912.  
  10913.  
  10914.                                     WP SERVER:
  10915.  
  10916.        Generation of messages to the white pages master server is included
  10917.        in MSYS.  This sends the information users give in the N, NH, NZ and
  10918.        NQ commands to the WP server when it is changed (or initially given)
  10919.        as well as periodically.  Note that MSYS does not respond to messages
  10920.        to WP but merely passes them on without modification.  WP messages
  10921.        are NOT generated for users with any of the following
  10922.        characteristics: locked, homebbs of ?, bbs  system, and/or baduser.
  10923.        The hierarchical address is currently defaulted to
  10924.        N6IYA.#NOCAL.CA.USA.NOAM, but may be changed by the MASterserver
  10925.        command.
  10926.  
  10927.  
  10928.  
  10929.  
  10930.  
  10931.                             KANTRONICS 3.0 EPROM users:
  10932.  
  10933.        I am told you will have to make a TNC setup file and include the
  10934.        following:
  10935.             INTFACE KISS
  10936.             RESET
  10937.        You may also need to include a line with one or more control-c
  10938.        characters before these two lines in your file.
  10939.  
  10940.        Later versions of the KPC series seem to work OK with no MSYSTNC.#
  10941.        file.
  10942.  
  10943.  
  10944.  
  10945.  
  10946.  
  10947.  
  10948.  
  10949.  
  10950.  
  10951.  
  10952.  
  10953.  
  10954.  
  10955.  
  10956.  
  10957.  
  10958.  
  10959.  
  10960.  
  10961.  
  10962.  
  10963.  
  10964.  
  10965.  
  10966.  
  10967.  
  10968.  
  10969.        MSYS 1.18                                                   Page 171
  10970.  
  10971.  
  10972.  
  10973.  
  10974.  
  10975.  
  10976.                     FREQUENT PROBLEMS AND NOTES FROM THE AUTHOR
  10977.  
  10978.  
  10979.        IMPORTANT:  You must use the new version of MUTIL with this version
  10980.        of MSYS (i.e., run setup, function 9).  It is probably also a good
  10981.        idea to delete MSYS.HRD when going to a different version of MSYS or
  10982.        changing the port statements in MSYS.OPT!  You MUST also use the new
  10983.        MSYSMSGS.DAT file in the \HELP directory
  10984.  
  10985.        If you have problems getting MSYS going, here are some things to try
  10986.        that have helped many who have called:
  10987.         1.  Make sure you have FILES=40 and BUFFERS=20 in CONFIG.SYS
  10988.         2.  Try adding STACKS=0,0 to CONFIG.SYS
  10989.         3.  Get rid of anything resident (check AUTOEXEC.BAT and CONFIG.SYS)
  10990.         4.  Run MUTIL 4 (do this EVERY time you start MSYS)
  10991.         5.  Simplify MSYS.OPT as much as possible; remove all PORT
  10992.             statements
  10993.         6.  Delete your MSYS.DO file (after making a backup!)
  10994.  
  10995.        These items should get you to the point where MSYS will work.  From
  10996.        here try putting things back and see what causes failure.
  10997.  
  10998.  
  10999.                              OVERRUNS, FRAMING ERRORS
  11000.  
  11001.        On occasion, it may be useful to do an ST S command to see the status
  11002.        of your ports.  If you find that you have "OVERRUNS", you should
  11003.        probably make some adjustments in the MSYS.OPT file for speeds.  An
  11004.        overrun is a condition that occurs when the TNC delivers a character
  11005.        to the serial port and the computer does not process the character in
  11006.        time before another character is presented.  If the second character
  11007.        is presented before the first has been taken out, the UART will
  11008.        signal MSYS that there has been an overrun.  One possible solution is
  11009.        to use a buffered UART such as the 16550, which MSYS can properly
  11010.        utilize.  A second choice is to adjust the TNC to computer bit rate.
  11011.        The "normal" thinking is to run the port as fast as possible, but it
  11012.        may be useful to actually slow the TNC port to something over the
  11013.        radio speed but less than port maximum.  Empirical tests have shown
  11014.        that a TNC/computer speed of 4800 seems to work well on a 386-25
  11015.        machine using 8250 (non-buffered) UARTs.  In any event, you may need
  11016.        to adjust the TNC speed of the various ports until you minimize any
  11017.        overruns.  Modem speeds do need to be at least as fast as the highest
  11018.        speed on the modem, and preferably twice as fast.  To change the
  11019.        speed of a port, remember it is necessary to change the value in
  11020.        MSYS.OPT, then run MUTIL 9 before the changes will take effect.
  11021.  
  11022.  
  11023.  
  11024.  
  11025.  
  11026.  
  11027.  
  11028.  
  11029.  
  11030.        MSYS 1.18                                                   Page 172
  11031.  
  11032.  
  11033.  
  11034.  
  11035.  
  11036.                             ABRUPT STOPS IN FORWARDING
  11037.  
  11038.        It has been observed that ANY blank lines in the MSYSFWD.DEF, or any
  11039.        of the .FWD or .REV files included in the MSYS.FWD file will cause
  11040.        problems.  Make sure that ALL if the included files do NOT contain
  11041.        blank lines at the ends of the file.  Duplicate message numbers
  11042.        (caused during "crashes") will also cause a halt in the forwarding
  11043.        process.  See "Analizing" below.
  11044.  
  11045.                               MESSAGES DON'T FORWARD
  11046.  
  11047.        ALL forwarding is done on the @BBS.  In the hierarchical routing
  11048.        process, it is possible that a bbs will contain 2 or more of the
  11049.        criteria for forwarding.  MSYS will only forward based on the left-
  11050.        most item matched in the @BBS.  For example, let us assume that we
  11051.        forward all messages @ .#NEOH to WA8BXN.  We also forward messages @
  11052.        KB8AST to NO8M.  If a message @ KB8AST.#NEOH.OH comes in to be
  11053.        forwarded, MSYS will investigate the hierarchical routing and
  11054.        determine that all messages @ KB8AST go to NO8M.  If, for some
  11055.        reason, NO8M is not able to take the message, it will NOT be
  11056.        forwarded to WA8BXN as a "second choice".  It is therefore imperative
  11057.        that you not "over-specify" when setting up your forward files with
  11058.        the hierarchical routing. One major advantage of hierarchical routing
  11059.        is that you need not list EVERY bbs in a state or an area.  You only
  11060.        need to specify the hierarchical component.
  11061.  
  11062.  
  11063.        Make sure you execute the MERge command after every change in the
  11064.        \FWD files or in the MSYSFWD.DEF file.  Without doing this the system
  11065.        will not forward properly.
  11066.  
  11067.        NOTE:  You must have the file MSYSBBSB.DAT to be able to forward
  11068.        bulletins.
  11069.  
  11070.  
  11071.                 The system forwards messages to improper locations.
  11072.  
  11073.        Check to make sure that your MSYSFWD.DEF or MSYS.FWD files do not
  11074.        have improperly placed "*" characters or have imbedded empty lines at
  11075.        the end of the sections.  These "empty lines" are often found at the
  11076.        end of the xxx.FWD or xxx.REV files.
  11077.  
  11078.  
  11079.                           The system appears to work but:
  11080.                              Nothing is on the screen!
  11081.  
  11082.        Make sure you set the display type correctly in  the MSYS.OPT file.
  11083.        The command is WINDOW DISPLAY COLOR for color monitors  or
  11084.        WINDOW DISPLAY MONOCHROME  for monochrome monitors.
  11085.  
  11086.  
  11087.  
  11088.  
  11089.  
  11090.  
  11091.        MSYS 1.18                                                   Page 173
  11092.  
  11093.  
  11094.  
  11095.  
  11096.  
  11097.                       THE SYSTEM COMES UP AND APPEARS TO HANG
  11098.  
  11099.        This may be caused by a non-existent com port.  Check the lines in
  11100.        your MSYS.OPT to make sure the port addresses are correct.  Also,
  11101.        Rerun MUTIL 4 to insure the mail files are properly indexed.
  11102.  
  11103.  
  11104.                           SYSTEM REBOOTS AFTER FORWARDING
  11105.  
  11106.        This may be caused by having too many entries in your forwarding
  11107.        file.  Remember you may only have up to 400 different bbs names in
  11108.        your file!
  11109.  
  11110.  
  11111.               SYSTEM APPEARS TO BE STUCK WHILE ANALIZING FORWARD FILE
  11112.  
  11113.        This condition may occur after a "crash" even though MUTIL 4 has been
  11114.        run if there are duplicate message numbers in the list.  The message
  11115.        number will be shown in Window 6 on the F1 screen.  To resolve the
  11116.        problem, kill the duplicate message with the duplicate number, stop
  11117.        MSYS, rerun MUTIL 4, and restart MSYS.  At that point, the killed
  11118.        message may be added to the list with the \RESTore command from the
  11119.        bbs.
  11120.  
  11121.                               INPUT BUFFER SPACE LOW
  11122.  
  11123.        This message may occur while watching the F2 screen.  It refers to
  11124.        how much of the 4K input buffer is full.  It is not expanded beyond
  11125.        that, so the amount of memory that the MEM command returns has no
  11126.        significance.  INPUT BUFFER SPACE LOW most often indicates a shortage
  11127.        of cpu speed or something unusual that may be using a lot of cpu
  11128.        cycles.
  11129.  
  11130.                                  PERFORMANCE HINTS
  11131.  
  11132.        Don't let too many messages pile up in MAIL.BAK <DIR> before you
  11133.        delete them (after archiving if you wish) so the hard disk doesn't
  11134.        fill up.
  11135.  
  11136.        From time to time do a BID # command and see how many bids are
  11137.        active.  If its over 3 or 4 thousand its probably time to run MUTIL
  11138.        function 21 to get rid of the older bids.  You will get a warning
  11139.        message BID LIST NEARLY FULL when the bid list is about 2/3 full.
  11140.  
  11141.                                DELETE OLD LOG FILES.
  11142.  
  11143.        It is probably wise to put a statement: ??D10000 log in your
  11144.        MSYSTODO.DAT file to keep the log file from expanding to extremes.
  11145.        It is not uncommon to have a log file exceed 1 megabyte in a week's
  11146.        time!  The "log" statement will convert the MSYS.LOG file to a
  11147.        yymmdd.log, which then can be archived off line.
  11148.  
  11149.  
  11150.  
  11151.  
  11152.        MSYS 1.18                                                   Page 174
  11153.  
  11154.  
  11155.  
  11156.  
  11157.  
  11158.        While you are creating the MSYSTODO.DAT file, it is also not a bad
  11159.        idea to add a: ????0001 NODe SAve  just to keep your current node
  11160.        list in case of a reboot.
  11161.  
  11162.        Periodically (weekly?) you should also do the following:
  11163.  
  11164.             1.  Delete old BIDs using MUTIL 21
  11165.             2.  Delete old backup messages. (after running Mutil 10)
  11166.             3.  Delete all files in the /mail.bin directory (while MSYS is
  11167.                 NOT running!)
  11168.  
  11169.        Here are some suggestions from users of MSYS that they claim work.
  11170.        Use at your own risk!
  11171.  
  11172.        To cure the problem of certain TNCs that don't transmit properly on
  11173.        HF use radiospeed of 1200 in place of 300 in MSYS.OPT.  I can't
  11174.        imagine how this could help, but someone says it did for them (they
  11175.        weren't using MFJ TNCs which seem to have this kind of problem).  One
  11176.        thing you might want to try if you are having problems with a TNC on
  11177.        HF is to get a copy of KA9Q's net.exe program and see if you can use
  11178.        its AX.25 connect command with your TNC on HF.  If that fails as well
  11179.        the problem definitely is in the TNC.
  11180.  
  11181.  
  11182.                                    MFJ KISS MODE
  11183.  
  11184.        To put a MFJ TNC in kiss mode, try this in your MSYSTNC.# file
  11185.             ax off
  11186.             parity 0
  11187.             awlen 8
  11188.             conmode trans
  11189.             kiss on
  11190.             restart
  11191.  
  11192.  
  11193.        If you are just bringing up MSYS for the first time and experience
  11194.        crashes when mail is forwarded to you, or the size of BIDLIST.DAT is
  11195.        0 bytes, do the following to solve the problem:  Shut down MSYS
  11196.        (quit), delete BIDLIST.DAT, start MSYS, shut it down (the DOS DIR
  11197.        command should now show a size of 130000 for BIDLIST.DAT).  You
  11198.        should now be ready for normal operation.
  11199.  
  11200.  
  11201.                                        TIME
  11202.  
  11203.        If you find that the displayed time is different from what you have
  11204.        set the time to be in DOS, put the following in AUTOEXEC.BAT and
  11205.        reboot: SET TZ=EST5  (Obviously, set it to YOUR time zone!)  One more
  11206.        thing - the time can (and does) often get hosed up around the first
  11207.        of April and the end of October because of certain software language
  11208.        routines that attempt to account for the change in Daylight Savings
  11209.        time.  Not to worry (too much) because it will eventually make itself
  11210.        right (with maybe a little help from you!)
  11211.  
  11212.  
  11213.        MSYS 1.18                                                   Page 175
  11214.  
  11215.  
  11216.  
  11217.  
  11218.  
  11219.  
  11220.        You should also be aware that you may set your computer to local time
  11221.        (with the TS hhmmss command) and set the time that MSYS uses to GMT
  11222.        by use of the GMtime xx command where xx is your offset from GMT in
  11223.        hours.  As an alternative, you can set your computer to local time
  11224.        and utilize the RLinetime command to insert the "proper" GMT time
  11225.        (with the "Z") in the R: line.
  11226.  
  11227.  
  11228.  
  11229.  
  11230.  
  11231.  
  11232.  
  11233.  
  11234.  
  11235.  
  11236.  
  11237.  
  11238.  
  11239.  
  11240.  
  11241.  
  11242.  
  11243.  
  11244.  
  11245.  
  11246.  
  11247.  
  11248.  
  11249.  
  11250.  
  11251.  
  11252.  
  11253.  
  11254.  
  11255.  
  11256.  
  11257.  
  11258.  
  11259.  
  11260.  
  11261.  
  11262.  
  11263.  
  11264.  
  11265.  
  11266.  
  11267.  
  11268.  
  11269.  
  11270.  
  11271.  
  11272.  
  11273.  
  11274.        MSYS 1.18                                                   Page 176
  11275.  
  11276.  
  11277.  
  11278.  
  11279.  
  11280.                                  ADDITIONAL NOTES
  11281.  
  11282.        Paccom ROM version 1.1.5 may work better than 1.1.662
  11283.  
  11284.        If you are using DOS 3.3, you may need to put  STACKS=0,0 in your
  11285.        config.sys file.
  11286.  
  11287.        Home BBS replacement occurs only if @BBS is blank or the call of your
  11288.        bbs.
  11289.  
  11290.        Note:  If you run into problems with newer versions of QEMM and MSYS,
  11291.        try turning off the stealth option in QEMM.
  11292.  
  11293.  
  11294.                                OS2 REPORTED PROBLEMS
  11295.  
  11296.        Reference a message from N8LJL @ N8ITP.OH.USA.NA
  11297.  
  11298.        To All users of OS2 2.1 GA.  A problem has been found when using Com
  11299.        3 or Com 4 on IRQ 2 on ISA System Boards.  When a DOS Session is
  11300.        opened with access to a port using IRQ 2, the program may come up
  11301.        initially and work fine, but when you switch back to the DeskTop and
  11302.        return to the DOS Session, the screen data will not update.  This is
  11303.        most common on ProComm Version 2.01.  It appears that the interrupt
  11304.        control portion of the program is losing it brains as to where IRQ 2
  11305.        is assigned.  IBM is currently working on the problem.  Hopefully a
  11306.        resolution will not be too far down the road.
  11307.  
  11308.        This problem has existed since the advent of OS2 2.0 GA.  It will
  11309.        only affect those users who are trying to run more than 2 com ports
  11310.        and require access to IRQ 2.
  11311.  
  11312.        There is indeed an interrupt conflict, but all is not lost.  Refer to
  11313.        pages 376-380 in the OS2 manual, with particular note to page 378 and
  11314.        the "DOS settings" on 379.  The book missed a point that will be
  11315.        important. In config.sys and an explanation of what they do:
  11316.  
  11317.        DEVICE=C:\OS2\MOUSE.SYS SERIAL=COM1
  11318.        DEVICE=C:\OS2\COM.SYS (3,3e8,5)
  11319.        DEVICE=C:\OS2\MDOS\VCOM.SYS  (3,3e8,5)
  11320.  
  11321.        The second line sets up COM3, address 3e8, to IRQ5 for OS/2 sessions.
  11322.        The THIRD line does the same for DOS programs running under OS/2.
  11323.  
  11324.        I recommend using IRQ5 for COM3 unless you have an LPT2 printer
  11325.        attached.
  11326.  
  11327.  
  11328.  
  11329.  
  11330.  
  11331.  
  11332.  
  11333.  
  11334.  
  11335.        MSYS 1.18                                                   Page 177
  11336.  
  11337.  
  11338.  
  11339.  
  11340.  
  11341.        Here are the DOS settings K0TS is currently using in OS/2 with MSYS.
  11342.  
  11343.        COMM_DIRECT_ACCESS      ON
  11344.        COMM_HOLD               ON
  11345.        DOS_FILES               40
  11346.        DOS_HIGH                ON
  11347.        DOS_UMB                 ON
  11348.        EMS_HIGH_OS_MAP         96
  11349.        EMS_LOW_OS_MAP          576
  11350.        EMS_MEMORY_LIMIT        As high as possible
  11351.        IDLE_SENSITIVITY        93
  11352.        VIDEO_MODE_RESTRICTION  CGA
  11353.        XMS_MEMORY_LIMIT        As high as possible
  11354.        XMS_MEMORY_HMA          63
  11355.  
  11356.  
  11357.  
  11358.             IF MSYS DOESN'T SEEM TO BE WORKING PROPERLY, REMOVE ALL
  11359.             (EVERY LAST ONE!) RESIDENT PROGRAMS INCLUDING YOUR ENTIRE
  11360.             CONFIG.SYS (keeping files=40 and buffers=20) AND
  11361.             AUTOEXEC.BAT FILES AND SEE IF IT WORKS THAT WAY.  IF IT
  11362.             DOES, PUT THINGS BACK IN ONE AT A TIME TO SEE WHERE THE
  11363.             PROBLEM IS!
  11364.  
  11365.  
  11366.  
  11367.  
  11368.  
  11369.  
  11370.  
  11371.  
  11372.  
  11373.  
  11374.  
  11375.  
  11376.  
  11377.  
  11378.  
  11379.  
  11380.  
  11381.  
  11382.  
  11383.  
  11384.  
  11385.  
  11386.  
  11387.  
  11388.  
  11389.  
  11390.  
  11391.  
  11392.  
  11393.  
  11394.  
  11395.  
  11396.        MSYS 1.18                                                   Page 178
  11397.  
  11398.  
  11399.  
  11400.  
  11401.  
  11402.                            MSYS Utility Support Programs
  11403.                      (c) Copyright 1994 by HUB COMPUTERS, INC.
  11404.                                      MUTIL.EXE
  11405.  
  11406.        When you run MUTIL you will get a screen that is similar to:
  11407.  
  11408.        ==============================================================
  11409.  
  11410.        MSYS Utilities 1.18 by WA8BXN (C) 1994 Hub Computers, Inc.
  11411.  
  11412.        1    Change maximum number of messages
  11413.        *    Restore messages from backup directory MAIL.BAK        ***
  11414.        3    Print remote sysop phrase number table
  11415.        4    Check Mail index file integrity
  11416.        5    Test serial ports
  11417.        6    Print forwarding tree
  11418.        7    Convert JNOS domain.txt to MSYSHOST format
  11419.        8    Run log file analyzer
  11420.        9    Run SETUP program
  11421.        10   Scan message headers to create/add to BBSLIST.DAT
  11422.        11   Deletes old entries from BBSLIST.DAT and BBSTONTS.DAT  files.
  11423.        12   Fix mail index file (can be hazardous to use!)
  11424.        13   Process BBSLIST.DAT into BBSTONTS.DAT file
  11425.        14   Scan BBSTONTS.DAT to build BBSTONTS.BIN (indexed)
  11426.        15   Build list of archived messages
  11427.        16   Printer status
  11428.        17   MERge BBSLIST.DAT files
  11429.        18   Check MSYSNODE.DAT integrity
  11430.        19   Convert user files 1.05 & before <===> 1.06 and later
  11431.        20   Sort calls in the BBSLIST.DAT file
  11432.        21   Delete Old BIDS (and MIDS)
  11433.        22   Specify file name to use in place of printer
  11434.        99   Quit
  11435.  
  11436.        Enter number of selection: _
  11437.  
  11438.  
  11439.        *** This function has been replaced by the /RESTore command in the
  11440.        BBS
  11441.  
  11442.  
  11443.  
  11444.  
  11445.  
  11446.  
  11447.  
  11448.  
  11449.  
  11450.  
  11451.  
  11452.  
  11453.  
  11454.  
  11455.  
  11456.  
  11457.        MSYS 1.18                                                   Page 179
  11458.  
  11459.  
  11460.  
  11461.  
  11462.  
  11463.  
  11464.                  MUTIL Function 1 - Change max number of messages
  11465.  
  11466.        Input file(s):  MSYS.MSG
  11467.        Output files(s): MSYS.MSG
  11468.  
  11469.        The maximum number of messages that can be stored in MSYS is
  11470.        determined by the MSYS.MSG mail index file.  When MSYS starts
  11471.        running, it checks to see if there is an existing MSYS.MSG file.  If
  11472.        there is one, it is used (and contains the header lines of the
  11473.        messages that existed when MSYS was last stopped).  If there is no
  11474.        existing MSYS.MSG file, then an empty one is created, with a capacity
  11475.        of 100 messages.  This utility function can be used to change the
  11476.        size of an existing MSYS.MSG file.  You can increase or decrease the
  11477.        size of the file.  You can't make it smaller than the number of
  11478.        active messages.  The maximum number of active messages has been
  11479.        increased to 2000.
  11480.  
  11481.        NOTES:  There is a cost in memory requirements for each message
  11482.        possible.  Each message slot costs 138 bytes of memory;  100 messages
  11483.        (default maximum) thus takes 13800 bytes.  500 messages would take
  11484.        69,000 bytes and 2000 messages will take approximately 270,000 bytes
  11485.        (even if there weren't that many messages active).
  11486.  
  11487.        VALUES I USE:  I run with a 500 message maximum size.  Normally I
  11488.        have around 400 active messages.
  11489.  
  11490.        DIALOG  WITH  FUNCTION: You are first asked for the name of the
  11491.        MSYS.MSG file to modify:
  11492.  
  11493.        Enter path to MSYS Mail Index file or just press return to use
  11494.        MSYS.MSG: _
  11495.  
  11496.        Normally you will want to just press the return key.  If the current
  11497.        directory from which you are running MUTIL does not contain the
  11498.        MSYS.MSG file that you want to modify, you can specify a different
  11499.        path (or even a different file name if you have renamed MSYS.MSG for
  11500.        some reason).
  11501.  
  11502.        This function will next copy the specified MSYS.MSG file to a file
  11503.        called MSYS$$$.MSG which can be used to restore MSYS.MSG if for some
  11504.        reason this function fails.
  11505.  
  11506.        Next you are asked if you have run the Check Mail function (function
  11507.        4).  You should run Check Mail just before this function since
  11508.        attempting to change the maximum number of  message slots can produce
  11509.        very interesting (and usually bad) results if the original MSYS.MSG
  11510.        file is corrupt.  If you respond N then  this function terminates and
  11511.        you can then do the Check Mail function.  If you have just run Check
  11512.        Mail, then press Y to continue.  Note that you do NOT press return
  11513.        after either of these letters!
  11514.  
  11515.  
  11516.  
  11517.  
  11518.        MSYS 1.18                                                   Page 180
  11519.  
  11520.  
  11521.  
  11522.  
  11523.  
  11524.        If you responded Y, then the function continues, telling the current
  11525.        maximum number of messages, the current number of active messages,
  11526.        and some other information.  You are then asked for the new maximum
  11527.        number of messages you want.  This number must be greater or equal to
  11528.        the number of active messages.  It must also be less than or equal to
  11529.        2000.
  11530.  
  11531.        If the value you ask for is acceptable, the file will be changed to
  11532.        accommodate the new number.
  11533.  
  11534.        Next you will be asked to press a key to continue (try the return
  11535.        key).  This pause is put in the function so that you can see any
  11536.        additional messages that were produced before the screen  is cleared.
  11537.  
  11538.  
  11539.  
  11540.  
  11541.  
  11542.  
  11543.                         MUTIL Function 2 - Restore Messages
  11544.                              MOVED INTO MSYS PROGRAM!
  11545.  
  11546.        This function has been moved into the MSYS program with the SYSOP
  11547.        command of /REST [msg#] which MUST be done while connected to the
  11548.        bbs.
  11549.  
  11550.  
  11551.  
  11552.  
  11553.  
  11554.  
  11555.  
  11556.  
  11557.  
  11558.  
  11559.  
  11560.  
  11561.  
  11562.  
  11563.  
  11564.  
  11565.  
  11566.  
  11567.  
  11568.  
  11569.  
  11570.  
  11571.  
  11572.  
  11573.  
  11574.  
  11575.  
  11576.  
  11577.  
  11578.  
  11579.        MSYS 1.18                                                   Page 181
  11580.  
  11581.  
  11582.  
  11583.  
  11584.  
  11585.                    MUTIL Function 3 - Print Remote Sysop Phrase
  11586.  
  11587.        INPUT FILE(S):  MSYS.RMT
  11588.        OUTPUT FILE(S): Hardcopy printer output (optional)
  11589.  
  11590.        This function prints the contents of the MSYS.RMT file (used  for
  11591.        remote sysop verification).  The output of this function can be just
  11592.        the screen or also to the printer.  The output consists of printing
  11593.        the content of remote sysop phrase followed by a table that gives the
  11594.        character at each position in the phrase.
  11595.  
  11596.        DIALOG WITH FUNCTION:
  11597.        You are asked if you want hard copy output  (on  the  printer).
  11598.        Respond Y or N as desired.
  11599.  
  11600.        SAMPLE OUTPUT:
  11601.  
  11602.        Sample phrase.
  11603.           0   S
  11604.           1   a
  11605.           2   m
  11606.           3   p
  11607.           4   l
  11608.           5   e
  11609.           6
  11610.           7   p
  11611.           8   h
  11612.           9   r
  11613.           10  a
  11614.           11  s
  11615.           12  e
  11616.           13  .
  11617.  
  11618.        USAGE EXAMPLE:
  11619.  
  11620.        If  you did the \Sysop command as a remote user to get sysop
  11621.        privileges and got the following reply:
  11622.        Usage stats: Users=7 Msgs rcvd=3 Msgs sent=6 Max=12   you would type
  11623.        the following response:
  11624.        pp e
  11625.  
  11626.  
  11627.  
  11628.  
  11629.  
  11630.  
  11631.  
  11632.  
  11633.  
  11634.  
  11635.  
  11636.  
  11637.  
  11638.  
  11639.  
  11640.        MSYS 1.18                                                   Page 182
  11641.  
  11642.  
  11643.  
  11644.  
  11645.  
  11646.                 MUTIL Function 4 - Check Mail Index File Integrity
  11647.                                      (CHKMAIL)
  11648.  
  11649.        INPUT FILE(S):  MSYS.MSG
  11650.                        MAIL\MSG*.DAT
  11651.        OUTPUT FILE(S): MSYS.MSG
  11652.  
  11653.        This function checks the integrity of the Mail index file MSYS.MSG.
  11654.        It checks for such things as message slots on both the free and
  11655.        active lists, loops in either of these lists and  active message
  11656.        numbers that do not have text files in the MAIL directory (and  vice-
  11657.        versa).  It attempts to fix any errors if it can (and its generally
  11658.        pretty good at doing it).
  11659.  
  11660.        NOTE:  It will not delete any message text files in the MAIL
  11661.        directory if they don't  have active headers.  They will be reported
  11662.        but you will have to delete them yourself if you really don't want
  11663.        them.  You probably won't really want them, but  you decide!
  11664.  
  11665.        NOTE:  This function may be run in a batch file through MUTIL
  11666.        (without having to give its function number interactively) by
  11667.        running:
  11668.        MUTIL 4
  11669.  
  11670.  
  11671.        SAMPLE NORMAL OUTPUT:
  11672.  
  11673.        CHKMAIL - An MSYS Utility to verify mail index integrity
  11674.        MSYS Mail Index Checker
  11675.  
  11676.        head=0 free=1 next=2
  11677.        Reading Index file:
  11678.        There are 100 total message headers
  11679.  
  11680.        Pass 1:
  11681.        No cycles detected
  11682.        No headers on both lists
  11683.        All headers accounted for
  11684.        No message files without headers
  11685.        All active headers have files
  11686.        Press a key to continue
  11687.  
  11688.        COMMENTS:  I would strongly suggest you run this function EVERY time
  11689.        MSYS crashes for any reason (it should not crash often, if at all).
  11690.        To be on the safe side, many MSYS SYSOPs always run it when they
  11691.        start MSYS.
  11692.  
  11693.  
  11694.  
  11695.  
  11696.  
  11697.  
  11698.  
  11699.  
  11700.  
  11701.        MSYS 1.18                                                   Page 183
  11702.  
  11703.  
  11704.  
  11705.  
  11706.  
  11707.                        MUTIL Function 5 - Test serial ports
  11708.  
  11709.        INPUT FILE(S):  None
  11710.        OUTPUT FILE(S): None
  11711.  
  11712.        This function provides a very basic test of serial interfaces.  It is
  11713.        designed mostly to see if you got the addresses/int  numbers right
  11714.        for your machine.  It is not intended to be a brutal test of their
  11715.        operation!
  11716.  
  11717.        DIALOG WITH FUNCTION:
  11718.        After a table is displayed that lists the normal addresses for serial
  11719.        cards and corresponding interrupts, you will be asked if your machine
  11720.        has an 8086/8088 CPU chip in it.  If its a basic PC/XT compatible
  11721.        system, respond Y.  If you have an AT (80286) or higher level
  11722.        machine, respond with N.  If you have an 8088/8086 based system (PC
  11723.        class) then it will look for ints from  2,3,4, and 7.  If you say not
  11724.        8088/8086 (AT class and above) it will look for ints from 3,4,5, and
  11725.        7.  Depending on your response, certain interrupt handlers will  be
  11726.        installed.  You will then be asked for the address of the serial card
  11727.        you wish to check.  The answer you give must be in HEXADECIMAL.  A
  11728.        valid response might be 3F8, for example.  A simple check is made to
  11729.        see if there might be a serial port at the address you specify.  It
  11730.        is easily fooled if you specify the address of some other kind of I/O
  11731.        interface.
  11732.  
  11733.        If  there seems to be a device at the address you gave, a quick check
  11734.        will be made to see if it looks like an 8250 UART chip is used in
  11735.        your serial interface.  Internal loop back tests cannot be done with
  11736.        the newer UART chips.  If the test fails when you select internal
  11737.        loopback, try the external loopback option.  This requires a
  11738.        connector that will connect pins 2 & 3 together in place of the TNC
  11739.        you would normally connect.  External loopback can be used to test
  11740.        all types of UART chips.
  11741.  
  11742.        Next you will next be asked for a baud rate to test at.  Here you
  11743.        give a decimal number as an answer.  It probably doesn't make much
  11744.        difference what you give . (Don't try 0!).  I usually test at 1200
  11745.        baud.
  11746.  
  11747.  
  11748.  
  11749.  
  11750.  
  11751.  
  11752.  
  11753.  
  11754.  
  11755.  
  11756.  
  11757.  
  11758.  
  11759.  
  11760.  
  11761.  
  11762.        MSYS 1.18                                                   Page 184
  11763.  
  11764.  
  11765.  
  11766.  
  11767.  
  11768.  
  11769.        Now its your turn to type characters.  As indicated, press Esc  to
  11770.        terminate the test.  Normal response should be something like:
  11771.  
  11772.        Had IRQ 4 1 time(s),  A received
  11773.  
  11774.        If you press the letter 'A' key.  If interrupts aren't working you
  11775.        would see:
  11776.  
  11777.        Received A without interrupt.
  11778.  
  11779.        NOTE: This is not a performance test, just an address test.
  11780.  
  11781.  
  11782.  
  11783.  
  11784.  
  11785.  
  11786.  
  11787.  
  11788.  
  11789.  
  11790.  
  11791.  
  11792.  
  11793.  
  11794.  
  11795.  
  11796.  
  11797.  
  11798.  
  11799.  
  11800.  
  11801.  
  11802.  
  11803.  
  11804.  
  11805.  
  11806.  
  11807.  
  11808.  
  11809.  
  11810.  
  11811.  
  11812.  
  11813.  
  11814.  
  11815.  
  11816.  
  11817.  
  11818.  
  11819.  
  11820.  
  11821.  
  11822.  
  11823.        MSYS 1.18                                                   Page 185
  11824.  
  11825.  
  11826.  
  11827.  
  11828.  
  11829.                      MUTIL Function 6 - Print forwarding tree
  11830.  
  11831.        INPUT FILE(S):  MSYS.FWD
  11832.        OUTPUT FILE(S): Printer hard copy (optional)
  11833.  
  11834.        This function displays your forwarding file in two ways to tell you
  11835.        what callsigns you forward to each bbs you forward to and also to
  11836.        which bbs you forward each callsign.
  11837.  
  11838.        DIALOG WITH FUNCTION:
  11839.        You are asked if you want hard copy output  (on  the  printer).
  11840.        Respond Y or N as desired.
  11841.  
  11842.        The first part of the output consists of lines like
  11843.  
  11844.        WN7C ---> KA8Z WB8BII
  11845.  
  11846.        which means that messages with @WN7C are sent to either KA8Z or
  11847.        WB8BII(which ever one you can connect to first).
  11848.  
  11849.        The second part of the output consists of lines like
  11850.  
  11851.        KA3NVP <---   KA3NVP NTSNJ NTSNY NTSPA
  11852.  
  11853.        which means that you forward messages with KA3NVP NTSNJ NTSNY and
  11854.        NTSPA in some part of the @BBS field to KA3NVP.
  11855.  
  11856.  
  11857.        NOTE:     To pause the display, you must use ^NumLock (^S  won't
  11858.        work).         To resume scrolling, press any other key.
  11859.  
  11860.  
  11861.  
  11862.  
  11863.  
  11864.  
  11865.  
  11866.  
  11867.  
  11868.  
  11869.  
  11870.  
  11871.  
  11872.  
  11873.  
  11874.  
  11875.  
  11876.  
  11877.  
  11878.  
  11879.  
  11880.  
  11881.  
  11882.  
  11883.  
  11884.        MSYS 1.18                                                   Page 186
  11885.  
  11886.  
  11887.  
  11888.  
  11889.  
  11890.           MUTIL Function 7 - Convert JNOS domain.txt file to MSYS Format
  11891.  
  11892.        INPUT FILE:  domain.txt
  11893.        OUTPUT FILE: MSYSHOST.NEW
  11894.  
  11895.        DIALOG WITH FUNCTION:
  11896.        This utility takes the commonly available JNOS domain.txt file and
  11897.        converts it into a format that can be used by MSYS.  The file will
  11898.        still need to be edited to provide aliases. You will need to change
  11899.        the name to MSYSHOST.NET (from MSYSHOST.NEW), but the bulk of the
  11900.        typing will be handled automatically.
  11901.  
  11902.  
  11903.  
  11904.  
  11905.  
  11906.  
  11907.  
  11908.  
  11909.  
  11910.  
  11911.  
  11912.  
  11913.  
  11914.  
  11915.  
  11916.  
  11917.  
  11918.  
  11919.  
  11920.  
  11921.  
  11922.  
  11923.  
  11924.  
  11925.  
  11926.  
  11927.  
  11928.  
  11929.  
  11930.  
  11931.  
  11932.  
  11933.  
  11934.  
  11935.  
  11936.  
  11937.  
  11938.  
  11939.  
  11940.  
  11941.  
  11942.  
  11943.  
  11944.  
  11945.        MSYS 1.18                                                   Page 187
  11946.  
  11947.  
  11948.  
  11949.  
  11950.  
  11951.                      MUTIL Function 8 - Run Log File Analyzer
  11952.  
  11953.        INPUT FILE(S):  MSYS.LOG
  11954.                 MSYS.MSG
  11955.        OUTPUT FILE(S): Printer hard copy (optional)
  11956.  
  11957.        This program produces a listing of BBS usage.
  11958.  
  11959.        DIALOG WITH FUNCTION:
  11960.        You  are  asked if you want hard copy output  (on  the  printer).
  11961.        Respond Y or N as desired.
  11962.  
  11963.        SAMPLE OUTPUT:
  11964.        ==============================================================
  11965.        From Wed Mar 01 15:23:48 1989 to Mon May 229 00:57:03 1989
  11966.        Station  Connects     Sends   Reads     Kills     Forwards
  11967.        HCLean      0           0       0        27         0
  11968.        N8UDK       3           1       1         0        12
  11969.        NT8V        0           1       1         0         0
  11970.        WA8BXN      4           0       0         1         9
  11971.        WB8ZZS    168          82      31        24         0
  11972.  
  11973.        LAST READ       MSG# TO   @BBS  Count  Title
  11974.        May 18            1 TEST         1    test
  11975.        Mar 23            7 TEST         2    test
  11976.        May 28            2 TEST         3    test
  11977.        Mar 02         8073 TEST         7    no title
  11978.  
  11979.        MSGINs 84  MSGKILLs 97  MSGFWDs 21  MSGREADs 33 RESTARTs 331  QUITs
  11980.        311  CONNECTS 175
  11981.        The following messages were received but not killed:
  11982.           1   2   3   20   21   8073
  11983.        (These should be active messages on your BBS!)
  11984.        ==============================================================
  11985.  
  11986.        NOTES:  This data is taken from my test system which uses  WB8ZZS as
  11987.        its call (Thanks to my wife Ruth!) Many strange things happen on this
  11988.        system as I am testing new software changes.
  11989.  
  11990.        The first line of the report gives the period of time covered  by the
  11991.        contents of the MSYS.LOG file that was read.
  11992.  
  11993.        The next section of the report lists stations that were active on the
  11994.        BBS and what they did.  The headings mean the following:
  11995.           Station - Callsign of the station
  11996.           Connects- Number of times the station connected (or the
  11997.                       SYSOP used the BB command).
  11998.           Sends  -  Number of messages sent by this station
  11999.           Reads  -  Number of messages read by this station
  12000.           Kills  -  Number of messages killed by this station
  12001.           Forwards- Number of messages forwarded to this station
  12002.  
  12003.  
  12004.  
  12005.  
  12006.        MSYS 1.18                                                   Page 188
  12007.  
  12008.  
  12009.  
  12010.  
  12011.  
  12012.        NOTE:  The callsign HCLean indicates activity by the House Cleaning
  12013.        routine.
  12014.  
  12015.        The next section lists messages that were read during the period,
  12016.        sorted in increasing order of number of reads .  The meaning of the
  12017.        headings is:
  12018.           LAST READ - Date the message was last read
  12019.           MSG#    - The number of the message on the bbs
  12020.           TO      - The "TO" station callsign of the message
  12021.           @BBS    - The "@" field of the message.
  12022.           Count   - The number of times the message was read
  12023.           Title   - The title of the message
  12024.  
  12025.        NOTE:  Private messages are not shown,  only bulletins.  This
  12026.        section is useful to see what interest there is in the various types
  12027.        of messages.
  12028.  
  12029.        The next section provides overall counts of various activities:
  12030.           MSGINs      The number of messages that were sent to the BBS
  12031.           MSGKILLs    The number of messages that were killed
  12032.           MSGFWDS     The number of messages forwarded by the BBS to other
  12033.                       systems.  Note: If a bulletin is forwarded to 4
  12034.                       different systems, it counts as 4 forwards
  12035.           MSGREADs    Total number of Read commands used on BBS
  12036.           RESTARTs    Number of times MSYS was started
  12037.           QUITs       Number of times MSYS was gracefully shut down using
  12038.                       ^F4 or Quit command.  Restarts - quits is the number
  12039.                       of crashes for whatever reason.
  12040.           CONNECTS    Number of user connects to BBS + SYSOP BB cmds
  12041.  
  12042.        The final section of the report gives a list of message numbers that
  12043.        were assigned to messages sent to the system but not killed.
  12044.        Normally these message numbers should be active messages on the BBS.
  12045.        If they aren't, they may be messages to restore since they got lost
  12046.        somehow.
  12047.  
  12048.  
  12049.  
  12050.  
  12051.  
  12052.  
  12053.  
  12054.  
  12055.  
  12056.  
  12057.  
  12058.  
  12059.  
  12060.  
  12061.  
  12062.  
  12063.  
  12064.  
  12065.  
  12066.  
  12067.        MSYS 1.18                                                   Page 189
  12068.  
  12069.  
  12070.  
  12071.  
  12072.  
  12073.  
  12074.                        MUTIL Function 9 - Run Setup Program
  12075.  
  12076.        INPUT FILE(S):  MSYS.OPT
  12077.        OUTPUT FILE(S): MSYS.DEF
  12078.  
  12079.        This function sets default initialization parameters.  IT MUST BE RUN
  12080.        BEFORE YOU CAN RUN MSYS THE FIRST TIME and any time you change
  12081.        MSYS.OPT.  It is documented elsewhere in this document.
  12082.  
  12083.        DIALOG WITH FUNCTION:
  12084.        You are asked if you want hard copy output (on the printer).  Respond
  12085.        Y or N as desired.
  12086.  
  12087.  
  12088.  
  12089.  
  12090.  
  12091.  
  12092.  
  12093.  
  12094.  
  12095.  
  12096.  
  12097.  
  12098.  
  12099.  
  12100.  
  12101.  
  12102.  
  12103.  
  12104.  
  12105.  
  12106.  
  12107.  
  12108.  
  12109.  
  12110.  
  12111.  
  12112.  
  12113.  
  12114.  
  12115.  
  12116.  
  12117.  
  12118.  
  12119.  
  12120.  
  12121.  
  12122.  
  12123.  
  12124.  
  12125.  
  12126.  
  12127.  
  12128.        MSYS 1.18                                                   Page 190
  12129.  
  12130.  
  12131.  
  12132.  
  12133.  
  12134.                      MUTIL Function 10 - Scan Message Headers
  12135.                            to create/add to BBSLIST.DAT
  12136.  
  12137.        INPUT FILES:   MAIL.BAK\MSG*.DAT (or specified directory) BBSLIST.DAT
  12138.                       (if it exists)
  12139.        OUTPUT FILE:   BBSLIST.DAT
  12140.  
  12141.        This program scans backup mail message files that are (or were
  12142.        originally found) in the MAIL.BAK directory to determine what BBS
  12143.        stations have been "seen" (using the R: lines added by each BBS as it
  12144.        forwards a message).
  12145.  
  12146.        DIALOG WITH FUNCTION:
  12147.  
  12148.        You will be asked to give the name of the directory that contains the
  12149.        messages to be scanned or to press return to use the MAIL.BAK
  12150.        directory directly.
  12151.  
  12152.        NOTE: This function may be run from a batch file by using either:
  12153.             MUTIL 10
  12154.        or:
  12155.             MUTIL 10 dirname
  12156.  
  12157.        In the first form (MUTIL 10) it will be assumed that the input files
  12158.        are in the MAIL.BAK directory.  In the second form (MUTIL 10 dirname)
  12159.        the files are assumed to be in the given directory name.
  12160.  
  12161.  
  12162.        OUTPUT FILE FORMAT:
  12163.        The first line of BBSLIST.DAT gives the date this function was run to
  12164.        create or add to the file.
  12165.  
  12166.        The remaining lines in the file consist of the following fields:
  12167.        callsign of bbs
  12168.        location of bbs
  12169.        postal code of bbs
  12170.        number of times this call has been seen
  12171.  
  12172.        Note: If you choose to edit this file, be sure to keep things in the
  12173.        same columns.  Also note that the callsigns are lined up using the
  12174.        digit of the callsign.  The list is sorted  by  digit in callsign,
  12175.        letters after the digit, and then letters before the digit (pretty
  12176.        much callbook order).  Calls that do not begin with A, K, N, or W are
  12177.        grouped together at the end of the list, with an * in the first
  12178.        position in the record (non-US calls).
  12179.  
  12180.  
  12181.  
  12182.  
  12183.  
  12184.  
  12185.  
  12186.  
  12187.  
  12188.  
  12189.        MSYS 1.18                                                   Page 191
  12190.  
  12191.  
  12192.  
  12193.  
  12194.  
  12195.                       MUTIL Function 11 - Deletes Old Entries
  12196.                          From BBSLIST.DAT and BBSTONTS.DAT
  12197.  
  12198.  
  12199.        This utility function will prompt the user to determine what the
  12200.        oldest record date you wish to keep in a yymmdd sequence.  It will
  12201.        then edit the files to delete BBS records older than the specified
  12202.        date.  It might be a good idea to then run MUTIL Function 10 to add
  12203.        any new BBS's to the list before running MUTIL Function 13.
  12204.  
  12205.  
  12206.                       MUTIL Function 12 - Fix Mail Index File
  12207.  
  12208.        ***** WARNING ***** This function can DESTROY the mail index file
  12209.  
  12210.        INPUT FILE(S): MSYS.MSG
  12211.                       MAIL\MSG*.DAT
  12212.        OUTPUT FILE:   MSYS.MSG
  12213.  
  12214.        This function allows manual inspection, checking and modification of
  12215.        the mail index file.  It is a utility I wrote to see what destroyed a
  12216.        mail file and perhaps fix it.  There is one function that may be
  12217.        useful to most SYSOPS, that allows you to specify the next message
  12218.        number to be assigned to incoming messages.  You may want to do this
  12219.        if you were running some other bbs and want to continue using message
  12220.        numbers from where you left off.  Personally I would suggest that you
  12221.        don't do this but rather start with the default value 1.  But its up
  12222.        to you!
  12223.  
  12224.        NOTE:  Make a copy of your existing MSYS.MSG file before using this
  12225.        function!
  12226.  
  12227.        NOTE:  Most of the checking and repair functions have been automated
  12228.        in the CHKMAIL function (MUTIL Function 4).
  12229.  
  12230.        DIALOG WITH FUNCTION: You are first asked for the name of the
  12231.        MSYS.MSG file to modify:
  12232.  
  12233.        Enter MSYS message header file name or simply press return for
  12234.        MSYS.MSG: _
  12235.  
  12236.        Normally you will want to just press the return key.  If the current
  12237.        directory from which you are running MUTIL does not contain the
  12238.        MSYS.MSG file that you want to modify,  you can specify a different
  12239.        path (or even a different file name if you have renamed MSYS.MSG for
  12240.        some reason).
  12241.  
  12242.  
  12243.  
  12244.  
  12245.  
  12246.  
  12247.  
  12248.  
  12249.  
  12250.        MSYS 1.18                                                   Page 192
  12251.  
  12252.  
  12253.  
  12254.  
  12255.  
  12256.        To change the number that will be assigned to the next message, use
  12257.        the following procedure:
  12258.        Select F8 (Manual changes)
  12259.        Select F5 (Change Next)
  12260.        Enter new value for next message number to be used.
  12261.        Select F10 (Return to previous menu)
  12262.        Select F9 (Save changes and quit)
  12263.  
  12264.  
  12265.                                RENUMBERING MESSAGES
  12266.  
  12267.        All active messages may be renumbered using MUTIL function 12.
  12268.        You should renumber your messages when you reach about message number
  12269.        64000.  As message numbers increase above this they will wrap around
  12270.        back to 0 if you don't use this function.  Some of the L command
  12271.        options will not work properly if newer messages have numbers smaller
  12272.        than older ones.  To renumber the messages, go through the following
  12273.        steps:
  12274.            1 - Start the MUTIL program
  12275.            2 - Type 12 and return
  12276.            3 - Press return to accept use of MSYS.MSG
  12277.            4 - Press F8 for manual changes
  12278.            5 - Press F6 for Renumber messages
  12279.            6 - Type new starting message number (1 is good) then
  12280.                press return
  12281.            7 - Press F10 to return to previous menu
  12282.            8 - Press F9 to save changes
  12283.            9 - Press return to go back to main menu
  12284.           10 - Type 99 and return to exit
  12285.  
  12286.        It should be noted that any files in the mail.bin directory should
  12287.        also be deleted when renumbering messages.
  12288.  
  12289.  
  12290.  
  12291.  
  12292.  
  12293.  
  12294.  
  12295.  
  12296.  
  12297.  
  12298.  
  12299.  
  12300.  
  12301.  
  12302.  
  12303.  
  12304.  
  12305.  
  12306.  
  12307.  
  12308.  
  12309.  
  12310.  
  12311.        MSYS 1.18                                                   Page 193
  12312.  
  12313.  
  12314.  
  12315.  
  12316.  
  12317.                   MUTIL Function 13 - BBSLIST.DAT to BBSTONTS.DAT
  12318.  
  12319.        INPUT FILES:  BBSLIST.DAT
  12320.                      ZIPCODES.DAT
  12321.                      STATES.DAT
  12322.                      ROUTES.DAT
  12323.        OUTPUT FILE:  BBSTONTS.DAT
  12324.  
  12325.        This function builds a list of BBS calls (and optionally zip codes)
  12326.        and the corresponding xx designator to which they should be
  12327.        forwarded.
  12328.  
  12329.        If you select processing US BBS calls by state the data found in
  12330.        BBSLIST.DAT is scanned for state and zip code.  The state is
  12331.        identified as being something after a comma in the location field
  12332.        that matches the list of state two letter codes found in  the
  12333.        STATES.DAT file.  If only one state is found and it corresponds to
  12334.        the zip code found, then the BBS call is automatically assigned to
  12335.        xx  where xx is the state abbreviation.  If either of these pieces of
  12336.        information is missing, or they do not match the test fails and you
  12337.        are asked to decide what state the bbs belongs in.
  12338.  
  12339.        DIALOG WITH FUNCTION:
  12340.  
  12341.        You will be asked if you want to include state routings for ZIPCODES.
  12342.        You should reply Y the first time you are creating the BBSTONTS.DAT
  12343.        file.  Otherwise reply N.  If you delete BBSTONTS.DAT for some
  12344.        reason, you should reply Y the first time you create a new one.
  12345.  
  12346.        If the state of the BBS cannot be automatically determined, you will
  12347.        get a screen that looks like this:
  12348.  
  12349.        ==============================================================
  12350.              WB8ZZS   KIRTLAND OH        44094   (4)
  12351.  
  12352.        State/ZIP check failed - Zipstate OH
  12353.        Enter two letter state code then <Return key> or press <Escape key>
  12354.        then <Return key> to ignore or just press <Return key> to use OH
  12355.  
  12356.        =============================================================
  12357.  
  12358.        The first line of this screen is the line from BBSLIST.DAT that is
  12359.        being considered.  The next line gives the state that corresponds to
  12360.        the zip code (if available).  The third line gives the guess that can
  12361.        be accepted if you just press return.  If the guess is good, hit
  12362.        return.  If you want to use a different state, type the two letter
  12363.        code for that state and then press return.  If you want to omit this
  12364.        call from the output file, press some non-letter key before pressing
  12365.        return.  Space bar, return works well.
  12366.  
  12367.  
  12368.  
  12369.  
  12370.  
  12371.  
  12372.        MSYS 1.18                                                   Page 194
  12373.  
  12374.  
  12375.  
  12376.  
  12377.  
  12378.        In this example, the state could not be identified because  there is
  12379.        no comma between the city and the state.  (It would be nice if
  12380.        everyone used standardized R: lines!) The guess of OH was made from
  12381.        the zip code alone.
  12382.  
  12383.        When the US calls have been processed, you will be asked if you want
  12384.        to process non-US calls.  If you have earlier chosen not to process
  12385.        US calls by states/zipcodes, the US calls will be processed with all
  12386.        the other calls if you choose to process non-US calls.  This feature
  12387.        is useful for non-US hams that handle all US messages as just going
  12388.        to the US.
  12389.  
  12390.        If you choose to process the calls at this point, you will be
  12391.        presented with screens that  list an entire entry from the
  12392.        BBSLIST.DAT file.  Following this line will be the callsign of the
  12393.        BBS identified from the line.  Using the call prefixes found in the
  12394.        ROUTES.DAT file, a guess will be made as to what routing should be
  12395.        used for the given call.  You may then choose to ignore the call, to
  12396.        use the routing obtained from the call prefix (if any) or to type the
  12397.        complete route you desire.
  12398.  
  12399.        A sample screen might look like this:
  12400.  
  12401.        =============================================================
  12402.           *  WB8ZZS   KIRTLAND OH        44094   (4)
  12403.        Callsign:    WB8ZZS
  12404.        Possible route: USA.NA
  12405.  
  12406.        Press <Escape key> <Return key> to ignore
  12407.        Type desired routing then press <Return key> or
  12408.           just press <Return key> to use USA.NA
  12409.  
  12410.        =============================================================
  12411.  
  12412.        BBSTONTS.DAT FILE FORMAT:
  12413.        This  is an ASCII file containing in bytes 1 to 9 a BBS  call  or
  12414.        zipcode (left justified, possibly with wildcard * indicator), and the
  12415.        corresponding designator to which messages for that BBS  call or zip
  12416.        code should be forwarded beginning in position 10 .  Example lines:
  12417.  
  12418.        89*     NV
  12419.        WB8ZZS  OH
  12420.        VK1XX   AUS.AS
  12421.  
  12422.        NOTE:  Bulletin routing designator (like ARRL) should NOT appear in
  12423.        this file.
  12424.  
  12425.        NOTE:  The file is sorted in ascending order using the entire record
  12426.        as key.
  12427.  
  12428.        NOTE:  There should be no duplicates of calls/zip codes found in the
  12429.        first 9 bytes of the records.
  12430.  
  12431.  
  12432.  
  12433.        MSYS 1.18                                                   Page 195
  12434.  
  12435.  
  12436.  
  12437.  
  12438.  
  12439.                  MUTIL Function 14 - BBSTONTS.DAT to BBSTONTS.BIN
  12440.  
  12441.        INPUT FILE(S):  BBSTONTS.DAT
  12442.        OUTPUT FILE(S): BBSTONTS.BIN
  12443.  
  12444.        This function builds an index of the calls in  the BBSTONTS.DAT file,
  12445.        placing the index at the beginning of the BBSTONTS.BIN file.  After
  12446.        the index, the contents of BBSTONTS.DAT is copied to BBSTONTS.BIN.
  12447.  
  12448.        DIALOG WITH FUNCTION:
  12449.  
  12450.        This function does not require any keyboard input.
  12451.  
  12452.  
  12453.        NOTE:  The format of the resulting file is such that no attempt
  12454.        should be made to edit it.  With care, BBSTONTS.DAT may be edited and
  12455.        the result then processed by this function.
  12456.  
  12457.        NOTE:  The file BBSTONTS.BIN is used by MSYS.  The files BBSTONTS.DAT
  12458.        and BBSLIST.DAT are NOT used directly used by MSYS and may be stored
  12459.        on a diskette, if desired, when MSYS is running.  I just keep them in
  12460.        the normal MSYS directory.
  12461.  
  12462.  
  12463.  
  12464.  
  12465.  
  12466.  
  12467.                 MUTIL Function 15 - Build List of Archived Messages
  12468.  
  12469.        This function will look at messages found in a given directory (in
  12470.        MAIL.BAK format) and construct a file of the message headers.  The
  12471.        result is a file of all your messages like doing a L command on the
  12472.        BBS for every message that has passed through your system.  You can
  12473.        use the grep function on it to find messages with some particular
  12474.        string of characters in their header line.  I use it to find a
  12475.        message when I think to myself "I remember there was a message about
  12476.        ...  one time".  Then knowing the message number you can go back to
  12477.        your archive diskettes and extract the complete text.
  12478.  
  12479.  
  12480.  
  12481.  
  12482.  
  12483.  
  12484.  
  12485.  
  12486.  
  12487.  
  12488.  
  12489.  
  12490.  
  12491.  
  12492.  
  12493.  
  12494.        MSYS 1.18                                                   Page 196
  12495.  
  12496.  
  12497.  
  12498.  
  12499.  
  12500.  
  12501.                         MUTIL Function 16 - Printer Status
  12502.  
  12503.        This function provides a very simple printer test to see if its
  12504.        connected and can be initialized.
  12505.  
  12506.  
  12507.  
  12508.                     MUTIL Function 17 - MERge BBSLIST.DAT Files
  12509.  
  12510.        This function takes as its input your current BBSLIST.DAT file (which
  12511.        it first renames to BBSLIST.BAK) and another file you specify  in the
  12512.        same format as BBSLIST.DAT) and merges the two files into one called
  12513.        BBSLIST.DAT.  I use this function to merge the BBSLIST.DAT file that
  12514.        some of the users of MSYS have sent me.  This allows me to include in
  12515.        my file some bbs calls that normally would not have been seen in
  12516.        messages passing through my system.
  12517.  
  12518.  
  12519.  
  12520.  
  12521.                  MUTIL Function 18   Check MSYSNODE.DAT Integrity
  12522.  
  12523.        This function performs the following functions:
  12524.  
  12525.  
  12526.        MSYSNODE.DAT viewing and repair program
  12527.  
  12528.         0     Printer echo toggle (now OFF)
  12529.         1     List active neighbors
  12530.         2     List all neighbor slots
  12531.         3     List active known destinations
  12532.         4     List all known destination slots
  12533.         5     Data consistency check
  12534.         6     View given neighbor or destination
  12535.        99     Exit
  12536.  
  12537.        Any output from the program will be directed to the screen unless the
  12538.        printer has been toggled on.
  12539.  
  12540.  
  12541.  
  12542.  
  12543.                       MUTIL Function 19 - Convert User Files
  12544.                           1.05 & Before To 1.06 and later
  12545.  
  12546.        Version 1.05 and earlier used a different format for storing user
  12547.        files.  This utility probably will be of little use to most current
  12548.        users.
  12549.  
  12550.  
  12551.  
  12552.                      MUTIL Function 20 - Sort BBSLIST.DAT File
  12553.  
  12554.  
  12555.        MSYS 1.18                                                   Page 197
  12556.  
  12557.  
  12558.  
  12559.  
  12560.  
  12561.  
  12562.        This utility will sort the callsigns in the BBSLIST.DAT file.  It
  12563.        will sort the bbs callsigns based on number, suffix after the number,
  12564.        prefix to the number and generate a new file called BBSLIST.NEW  At
  12565.        the conclusion of this operation, it will suggest that you rename the
  12566.        files in the proper manner.  This utility has been revised in MUTIL
  12567.        1.16 to operate faster and to permit more BBS calls.
  12568.  
  12569.  
  12570.  
  12571.                   MUTIL Function 21 - Delete Old BIDs (and MIDs)
  12572.  
  12573.        This function deletes old BIDs/MIDs from the file BIDLIST.DAT.  It
  12574.        asks for the number of days worth of bids that should be kept.  Run
  12575.        it periodically (maybe once a week when you do your hard disk
  12576.        backups).  The bid file can hold up to 6500 entries  The more it has,
  12577.        the slower it works.  The maximum number of BIDs in the BID file is
  12578.        settable.
  12579.  
  12580.  
  12581.  
  12582.  
  12583.                    MUTIL Function 22 - Specify Printer File Name
  12584.  
  12585.        The file you specify will be opened and will receive any output that
  12586.        would normally go to the printer.  Any existing data in the given
  12587.        file will be lost.  If you want to abort this  function, simply press
  12588.        return when asked for the file name.
  12589.  
  12590.  
  12591.  
  12592.  
  12593.  
  12594.  
  12595.  
  12596.  
  12597.  
  12598.  
  12599.  
  12600.  
  12601.  
  12602.  
  12603.  
  12604.  
  12605.  
  12606.  
  12607.  
  12608.  
  12609.  
  12610.  
  12611.  
  12612.  
  12613.  
  12614.  
  12615.  
  12616.        MSYS 1.18                                                   Page 198
  12617.  
  12618.  
  12619.  
  12620.  
  12621.  
  12622.                                SAMPLES OF MSYS FILES
  12623.                      (c) Copyright 1994 by HUB COMPUTERS, INC.
  12624.  
  12625.  
  12626.  
  12627.                                      MSYS.OPT:
  12628.  
  12629.        port 0 at $3E0 int 7 speed 4800 name 145.01 RADIOSPEED 1200 TNCTYPE 1
  12630.        port 1 at $2E8 int 7 speed 9600 name 223.68 RADIOSPEED 1200 TNCTYPE 1
  12631.        port 2 at $3E8 int 7 speed 4800 name 145.05 RADIOSPEED 1200 TNCTYPE 1
  12632.        port 3 at $2F0 int 7 speed 9600 name >AKRNODE RADIOSPEED 9600
  12633.        port 4 at $2F8 int 3 speed 19200 name MODEM RADIOSPEED 1200 TNCTYPE 2
  12634.        port 5 at $3F8 int 4 speed 9600 name PACTOR_80M
  12635.        numchans 15
  12636.        bbs alias akrbbs
  12637.        bbs call wb8bii
  12638.        id call k8eiw
  12639.        id every 30
  12640.        forward call wb8bii-1
  12641.        answer call k8eiw-15
  12642.        kanode call wb8bii-3
  12643.        sysop name Don
  12644.        sysop qth Cuyahoga Falls
  12645.        sysop zip 44223
  12646.        process id window 2
  12647.        monitor outgoing on
  12648.        window display color
  12649.        window 0 size 1 1 80 13
  12650.        Window 6 size 1 23 48 25
  12651.        make
  12652.  
  12653.  
  12654.  
  12655.  
  12656.  
  12657.  
  12658.  
  12659.  
  12660.  
  12661.  
  12662.  
  12663.  
  12664.  
  12665.  
  12666.  
  12667.  
  12668.  
  12669.  
  12670.  
  12671.  
  12672.  
  12673.  
  12674.  
  12675.  
  12676.  
  12677.        MSYS 1.18                                                   Page 199
  12678.  
  12679.  
  12680.  
  12681.  
  12682.  
  12683.                                      MSYS.DO:
  12684.  
  12685.        *----------------CALLSIGN STUFF-------------------------------
  12686.        HCA WB8BII.#NEOH.OH.USA.NOAM
  12687.        HOST WB8BII
  12688.        NRI AKRON
  12689.        NRC WB8BII-1
  12690.        MYT WB8BII-1
  12691.        myip 44 70 242 6
  12692.        mya akrbbs
  12693.        *-----------------TNC PARAMETERS------------------------------
  12694.        monsf on
  12695.        check 0500
  12696.        *------------Turn on CTS for Modem and PACTOR ports
  12697.        cts 4 1
  12698.        cts 5 1
  12699.        *------------Set FRACK for ALL ports
  12700.        frack 12
  12701.        *------------Reset FRACK for high-speed matrix port
  12702.        frack 3 5
  12703.        *------------Set Response time, slot time, txtail and txdelay
  12704.        resp 1
  12705.        slot 10
  12706.        tac 2
  12707.        txt 5
  12708.        txd 0 35
  12709.        txd 1 30
  12710.        txd 2 35
  12711.        txd 3 5
  12712.        *------------Set maximum packet length, and maxframes per port
  12713.        paclen 236
  12714.        maxfr 0 4
  12715.        maxfr 1 7
  12716.        maxfr 2 4
  12717.        maxfr 3 7
  12718.        *------------Set p-persist
  12719.        PP 64
  12720.        *------------Turn Digipeat function off
  12721.        DPORTS $00
  12722.        DIGI OFF
  12723.        *-----------------NET/ROM PARAMETERS -------------------------
  12724.        *------------Adds New Neighbors Heard if On
  12725.        AUTOn off
  12726.        *------------Broadcast Interval 30 minutes
  12727.        BIN 1800
  12728.        *------------KaNode Turned off
  12729.        KPORTS $0
  12730.        *------------Net Default Window Size
  12731.        ND 7
  12732.        *------------Enable BBS in NetNode
  12733.        NETB 1
  12734.        *------------Enable Connect Comand in NetNode
  12735.        NETC ON
  12736.  
  12737.  
  12738.        MSYS 1.18                                                   Page 200
  12739.  
  12740.  
  12741.  
  12742.  
  12743.  
  12744.        *------------Net Full Function Hours
  12745.        NETFBBS 0-23
  12746.        *------------NetNode On
  12747.        NETN ON
  12748.        *------------Network Connect for BBSs Only (Off permits ALL)
  12749.        NETO 0
  12750.        *------------Mail-for beacons turned off if 1 (port MASK)
  12751.        NOBE $0
  12752.        *------------NetRom PORTS 0,1,2,3
  12753.        NPORTS $F
  12754.        *------------Network Time to Live
  12755.        NTL 15
  12756.        *------------Obsolescence Count Initial
  12757.        OCI 6
  12758.        *------------Obsolescence Count Min for Broadcast
  12759.        OCM 5
  12760.        *------------Path Quality of heard nodes port 0
  12761.        PQ 0 120
  12762.        *------------Path Quality of heard nodes port 1
  12763.        PQ 1 120
  12764.        *------------Path Quality of heard nodes port 2
  12765.        PQ 2 120
  12766.        *------------Path Quality of heard nodes port 3
  12767.        PQ 3 200
  12768.        *------------TCP ON PORTS 0,1,2,3
  12769.        TPORTS $F
  12770.        *------------Min. DESt Quality to record
  12771.        WQ 120
  12772.        *--------------------BBS PARMS--------------------------------
  12773.        *------------Kill on Forward OFF
  12774.        AUtokill OFF
  12775.        *------------Attended Mode ON (resolves GTOR problem)
  12776.        AT 1
  12777.        *------------Turns on AX25 Level 2
  12778.        AX25L2 on
  12779.        *------------Turns On AX25 Level 2 backoff (RNR)
  12780.        AX25b $F
  12781.        *------------BADUSER
  12782.        *------------BUDLISTC
  12783.        *------------Turns on BBS Node broadcast to network
  12784.        BBSNODE 1
  12785.        *------------Turns on BID function
  12786.        BID 1
  12787.        *------------Display Time for F2 Key (0=infinite)
  12788.        f2timer 0
  12789.        *------------FBB Compatibility/Compression On (SEE NEXT STATEMENT!)
  12790.        FBBC 2
  12791.        *------------FBB Compat./Compression OFF for MODEM PORT (PORT 4)
  12792.        FBBC 4 0
  12793.        *------------FBB Forward Group Number of Messages
  12794.        FBBG 5
  12795.        *------------Forward Time interval (- = every x minutes)
  12796.        fti -10
  12797.  
  12798.  
  12799.        MSYS 1.18                                                   Page 201
  12800.  
  12801.  
  12802.  
  12803.  
  12804.  
  12805.        *------------Network FBB Compatability/Compression On
  12806.        NETFBBC 2
  12807.        *------------Network FBB Forward Group Number of Messages
  12808.        NETFBBG 5
  12809.        *------------Network RLI Batch Size
  12810.        NETXB 5000
  12811.        *------------Network RLI Compression Option On
  12812.        NETXO ON
  12813.        *------------House Clean at x Minutes after 00:00
  12814.        HCL 10
  12815.        *------------Heard List turn off point if Dispatches < #
  12816.        HE 10
  12817.        *------------Initializes Printer before each File Printed (0=NO)
  12818.        IN 0
  12819.        *------------Makes Messages Private by default
  12820.        MAKEP ON
  12821.        *------------Maximum Bulletin Age
  12822.        MAXB 10
  12823.        *------------Allow Connects to SYSOP Keyboard
  12824.        MCON ON
  12825.        *------------Min Memory for Memory Low Busy Msg
  12826.        MINM 32000
  12827.        *------------Turns on Message Trailer Function
  12828.        MS on
  12829.        *------------Establishes New User default bits
  12830.        NEW $4040
  12831.        *------------Valid Non-Call in FROM field
  12832.        OK WP REQWP REQQTH
  12833.        *------------Turns on CallSign Server
  12834.        PC ON
  12835.        REQQTH ON
  12836.        REQDIR ON
  12837.        REQFIL ON
  12838.        *------------Adds Received BID to R: line
  12839.        RBid ON
  12840.        *------------Screen Save Setting
  12841.        SC 10
  12842.        *------------Sets TimeZone
  12843.        TIMezone EST
  12844.        *------------Adjusts GMT offset from local time(CHANGE WITH DST!)
  12845.        *------------(Mutually exclusive with RLine Time)
  12846.        *GMtime 5
  12847.        *------------Set R: line time offset from Local time (Mutually
  12848.        *------------exclusive with GMtime.
  12849.        RLinetime 5
  12850.        *------------Turns on SYSOP Verification
  12851.        VERIFY on
  12852.        *------------Adjust color of Sysop BBS screen
  12853.        WB 3 1
  12854.        WF 3 14
  12855.        *------------RLI Batch Size (non-compressed bytes)
  12856.        XB 5000
  12857.  
  12858.  
  12859.  
  12860.        MSYS 1.18                                                   Page 202
  12861.  
  12862.  
  12863.  
  12864.  
  12865.  
  12866.        *------------RLI Compression Option On
  12867.        XO ON
  12868.        *----------------NET/ROM NEIGHBORS----------------------------
  12869.        NODE ADD AKR:K8EIW-1 3 192
  12870.        NODE ADD #AKRU:K8EIW-2 3 200
  12871.        NODE ADD #AKRU2:WB8BII-9 3 200
  12872.        NODE ADD AKR220:K8EIW-11 3 200
  12873.        AUTODEST On
  12874.        NETNODE ON
  12875.        NODE RESTORE
  12876.        DESt REP AKR:K8EIW-1 K8EIW-1 3 0 230
  12877.        *-------------ARP ROUTING TABLE-------------------------------
  12878.        arp add w8upd -2 44 70 241 1 /24
  12879.        arp add ka8z-4 -2 44 70 4 4
  12880.        arp add k8eiw-4 -2 44 70 4 32
  12881.        arp add wa8bxn-2 -2 44 70 4 6
  12882.        arp add wb8lvp-2 -2 44 70 247 3
  12883.        *------------Default TCP/IP ROUTE--------------
  12884.        DRoute w8upd 5
  12885.  
  12886.                                      MSYS.OTD:
  12887.        (Update into MSYS with GETM command.)
  12888.             <<< RADIO CLUB MEETING TONIGHT @ 8:00 PM - CITY BUILDING >>>
  12889.        ***
  12890.  
  12891.                                      MSYSK.OTD
  12892.  
  12893.              < Please try  ### MEDINA  Gateway 145.05 <-> 445.075 >
  12894.  
  12895.  
  12896.                                      MSYS.REP:
  12897.        NTS* ##### @2 @1    COMMENTS (NOT IN FILE!!!)
  12898.        440* * @1 NO8M      This sends ALL 440xx Zip Code to NO8M
  12899.        44001 * @1 N8ITP    This redirects 44001 Zip Code to N8ITP
  12900.        44003 * @1 KB8AST   This redirects 44003 Zip Code to KB8AST
  12901.        4403* * @1 N8ITP    This redirects 4403x Zip Code to N8ITP
  12902.        44030 * @1 KB8AST   This redirects 44030 Zip Code to KB8AST
  12903.                            The result of the above is that all ZIP coded
  12904.                            mail not specifically addressed to the 44001,03
  12905.                            or 3x Zip Codes will go to NO8M.
  12906.        441* * @1 W8GRG
  12907.        44107 * @1 NO8M
  12908.        46* * @1 W8LBZ      This redirects all Zip Code 46xxx to W8LBZ
  12909.        * OHNET @1 ALLOH
  12910.        * ARL @1 ARRL
  12911.        * ALLUSA @1 ALLUS
  12912.        * USA @1 ALLUS
  12913.        * K8EIW @1 WB8BII
  12914.        * WB8CQR @1 W8GRG
  12915.        * WB8BXN @1 WA8BXN
  12916.  
  12917.        NOTE:  THERE SHOULD BE NO BLANK LINES IN THE FILE!
  12918.               MAXIMUM of 150 entries in file!
  12919.  
  12920.  
  12921.        MSYS 1.18                                                   Page 203
  12922.  
  12923.  
  12924.  
  12925.  
  12926.  
  12927.  
  12928.                                      MSYS.RMT:
  12929.  
  12930.        PASSWORD TEST PHRASE 0123456789
  12931.  
  12932.        (This file can be more than 2K in length if you desire!  If you do
  12933.        much remote sysop activity, we STRONGLY urge a long password and
  12934.        utilize MSYS or MSYST as the remote terminal server. )
  12935.  
  12936.                                    MSYSBBSB.DAT:
  12937.  
  12938.        0
  12939.        1  KA8Z
  12940.        2  NO8M
  12941.        3  KB8DRN
  12942.        7  W8GRG
  12943.        8  WA8BXN
  12944.        9  NG8P
  12945.        10
  12946.        16 AD8I
  12947.        17 W8CQK
  12948.        18 KA0FPO
  12949.        19
  12950.        22 WA8DCE
  12951.        23 K1LT
  12952.        31 W8UPD
  12953.  
  12954.        NOTE: 32 is the MAXIMUM number of BBS's you can forward bulletins to!
  12955.  
  12956.  
  12957.  
  12958.  
  12959.  
  12960.  
  12961.  
  12962.  
  12963.  
  12964.  
  12965.  
  12966.  
  12967.  
  12968.  
  12969.  
  12970.  
  12971.  
  12972.  
  12973.  
  12974.  
  12975.  
  12976.  
  12977.  
  12978.  
  12979.  
  12980.  
  12981.  
  12982.        MSYS 1.18                                                   Page 204
  12983.  
  12984.  
  12985.  
  12986.  
  12987.  
  12988.                                    MSYSFWD.DEF:
  12989.  
  12990.        FILE CONTENTS  COMMENTS  (DO *NOT* INCLUDE COMMENTS IN FILE!)
  12991.  
  12992.        F1 w8upd       This is a straight forward out port 1 to a
  12993.        w8upd          local PBBS.  Only Messages @ W8UPD will be forwarded.
  12994.        -----          Necessary dashes! (5 minimum - 79 maximum)
  12995.        F3 kq8m
  12996.        @k8eiw-2       Forward through an adjacent TheNet node.
  12997.        .c #cledx      Connect command given to TheNet node.
  12998.        +to            Necessary triggers.
  12999.        ?from
  13000.        ?with
  13001.        .c kq8m
  13002.        #120           This extends the wait for connect to 120 seconds
  13003.        +to            seconds after the .C KQ8M command was issued.
  13004.        ?with
  13005.        ?Busy
  13006.        kq8m
  13007.        -----
  13008.        R3 ka0fpo      This is a forward with a request for Reverse Forward
  13009.        @k8eiw-2
  13010.        .c #cledx
  13011.        +to
  13012.        ?from                         This example shows how to use the
  13013.        ?with                         include file KA0FPO.REV.  The .rev
  13014.        .c kq8m-1                     extension indicates ka0fpo may
  13015.        #120                          reverse forward from this system.
  13016.        +to
  13017.        ?with
  13018.        ?Busy
  13019.        .c ka0fpo
  13020.        #120
  13021.        +to
  13022.        ?with
  13023.        ?Busy
  13024.        $c:\msys\fwd\ka0fpo.rev
  13025.        ------
  13026.        f1 wa8dce
  13027.        !25                           This indicates that WA8DCE will never
  13028.        $c:\msys\fwd\wa8dce.rev       be forwarded to, but will reverse
  13029.        --------                      forward all messages.
  13030.  
  13031.  
  13032.  
  13033.  
  13034.  
  13035.  
  13036.  
  13037.  
  13038.  
  13039.  
  13040.  
  13041.  
  13042.  
  13043.        MSYS 1.18                                                   Page 205
  13044.  
  13045.  
  13046.  
  13047.  
  13048.  
  13049.                                    MSYSHOST.NET:
  13050.  
  13051.  
  13052.        44.70.4.4 [ka8z] ka8z-4 ka8z.ampr.org        #Tom Barnes,canton,ka8z
  13053.        44.70.4.6 [wa8bxn] wa8bxn wa8bxn.ampr.org    #Mike Pechura,lake 
  13054.                                                           county,@wa8bxn
  13055.        44.70.245.2 [kb7yw] kb7yw kb7yw.ampr.org     #Fred Peachman,
  13056.                                                      brookfield @wb8lvp
  13057.  
  13058.        NOTE:  ALL ENTRIES FOR EACH HOST MUST BE ON ONE LINE!
  13059.  
  13060.  
  13061.                                    MSYSPASS.DAT:
  13062.  
  13063.        guest * 3 c:/msys/public
  13064.        anonymous * 3 c:/msys/public
  13065.        ka8z tom 7 c:/msys/public
  13066.        mike wa8bxn 7 c:/msys/public
  13067.        fred kb7yw 7 c:/msys/public
  13068.  
  13069.        The format is: call pass privilege base directory
  13070.        And is used for FTP access to the system.
  13071.  
  13072.  
  13073.                                     MSYSPASS.IP
  13074.  
  13075.        wa8bxn apple wa8bxn
  13076.        terry n8hsp n8hsp
  13077.        fred kb7yw kb7yw
  13078.        swiss normal no8m
  13079.  
  13080.        The format is: call pass callsign
  13081.        and is used for Telnet access to the bbs.
  13082.  
  13083.  
  13084.  
  13085.  
  13086.  
  13087.  
  13088.  
  13089.  
  13090.  
  13091.  
  13092.  
  13093.  
  13094.  
  13095.  
  13096.  
  13097.  
  13098.  
  13099.  
  13100.  
  13101.  
  13102.  
  13103.  
  13104.        MSYS 1.18                                                   Page 206
  13105.  
  13106.  
  13107.  
  13108.  
  13109.  
  13110.                                  Typical MSYSTNC.1
  13111.                                    (AEA PK-232)
  13112.  
  13113.        VHF OFF
  13114.        HB 300
  13115.        AWLEN 8
  13116.        PARITY 0
  13117.        CONMODE TRAN
  13118.        TRACE OFF
  13119.        HID OFF
  13120.        BE 0
  13121.        passall off
  13122.        RAWHDLC ON
  13123.        HP OFF
  13124.        PP ON
  13125.        KISS ON
  13126.        RESTART  OR  HOST ON         !!!CONSULT YOUR TNC MANUAL!!!
  13127.  
  13128.        NOTE:  The MSYSTNC.x files are associated with the corresponding
  13129.        tnctype.x specified in the MSYS.OPT file.  The above file COULD be
  13130.        named MSYSTNC.2 depending on your configuration.  Only the Kantronics
  13131.        TNCs are fixed at MSYSTNC.0
  13132.  
  13133.        NOTE: Consult your TNC manual to properly specify the proper
  13134.        parameters for your tnc to put it into the KISS mode.
  13135.  
  13136.        The TNC-2 clones, such as the MFJ 1270B or 1274, may benefit greatly
  13137.        by using the JKISS EPROM which forces the tnc to be in the KISS mode
  13138.        all the time.  The JKISS file is included on the distribution disk or
  13139.        is available as an EPROM from the Tucson Amateur Packet Radio
  13140.        organization.
  13141.  
  13142.  
  13143.  
  13144.  
  13145.  
  13146.  
  13147.  
  13148.  
  13149.  
  13150.  
  13151.  
  13152.  
  13153.  
  13154.  
  13155.  
  13156.  
  13157.  
  13158.  
  13159.  
  13160.  
  13161.  
  13162.  
  13163.  
  13164.  
  13165.        MSYS 1.18                                                   Page 207
  13166.  
  13167.  
  13168.  
  13169.  
  13170.  
  13171.  
  13172.                           INFORMATION FOR ADVANCED USERS
  13173.  
  13174.                             REPLACEABLE DIRECTORY NAMES
  13175.  
  13176.        Beginning in MSYS 1.04 you can specify alternate directory names to
  13177.        be used by MSYS in place of the standard ones by using appropriate
  13178.        DOS set commands.  The directory names that can be replaced and their
  13179.        default values are:
  13180.  
  13181.        Default             Set DOS variable
  13182.        Dir Name            to replace
  13183.        --------            ----------------
  13184.        FILES               MSYS:FILES
  13185.        FWD                 MSYS:FWD
  13186.        GREP                MSYS:GREPDIR
  13187.        HELP                MSYS:HELP
  13188.        MAIL                MSYS:MAIL
  13189.        YAPP                MSYS:YAPPDIR
  13190.  
  13191.  
  13192.        As an example, assume you have a RAM disk at drive E: and have set up
  13193.        a directory called HELP on E: and copied the normal help files to
  13194.        this directory.  You can then issue the following DOS command before
  13195.        starting MSYS:
  13196.        set MSYS:HELP=E:HELP
  13197.        and now MSYS will get the help files from the E:HELP directory.
  13198.  
  13199.        NOTE:  You must be very careful in using a RAMDISK since its contents
  13200.        are easily lost.  Also, you should probably not us a RAMDISK that
  13201.        takes space out of the normal 640K address space.
  13202.  
  13203.        NOTE:  You are not limited to using RAMDISKS in specifying the disk
  13204.        and/or directory to be used for the above directories.  You could
  13205.        specify floppy and/or hard disks as well.
  13206.  
  13207.        To establish a separate directory that is "GReppable", use the DOS
  13208.        SET command similar to this:   SET MSYS:GREPDIR=C:MSYS\GREP    Don't
  13209.        forget to create the C:\MSYS\GREP directory!
  13210.  
  13211.  
  13212.  
  13213.  
  13214.  
  13215.  
  13216.  
  13217.  
  13218.  
  13219.  
  13220.  
  13221.  
  13222.  
  13223.  
  13224.  
  13225.  
  13226.        MSYS 1.18                                                   Page 208
  13227.  
  13228.  
  13229.  
  13230.  
  13231.  
  13232.  
  13233.                               REPLACEABLE FILE NAMES
  13234.  
  13235.        You can also replace the following file names of files normally found
  13236.        in  the "MSYS" (default) directory.  Judicious choices can speed up
  13237.        operation and/or let you make use of multiple disk drives.  Poor
  13238.        choices can be a disaster!
  13239.  
  13240.        Default File   Set This DOS
  13241.        Name           Parameter to replace:   Notes
  13242.        -------------  --------------------- -----
  13243.        MAIL.BAK       MSYS:MAIL.BAK          (6)
  13244.        MAIL.BIN       MSYS:MAIL.BIN
  13245.        BBSTONTS.BIN   MSYS:BBSTONTS.BIN      (1)
  13246.        MSYS.FWD       MSYS:MSYS.FWD          (2)
  13247.        MSYS.HRD       MSYS:MSYS.HRD          (3)
  13248.        MSYS.LOG       MSYS:MSYS.LOG          (3)
  13249.        MSYS.MSG       MSYS:MSYS.MSG          (4)
  13250.        MSYS.USR       MSYS:MSYS.USR          (4)
  13251.        MSYSHOST.NET   MSYS:MSYSHOST.NET      (5)
  13252.        MSYSBBSB.DAT   MSYS:MSYSBBSB.DAT      (2)
  13253.        MSYSPASS.DAT   MSYS:MSYSPASS.DAT      (5)
  13254.  
  13255.  
  13256.        Notes:
  13257.        1. Very good candidate for ram disk (read only)
  13258.        2. Good to put on ram disk if you are careful
  13259.        3. These can be made NUL if you don't want them
  13260.        4. If you like to live very dangerously, consider putting them on
  13261.           ram disk.  Otherwise keep them on hard disk .  Updated frequently
  13262.           during normal operation, they are very important files.
  13263.        5. Good for ram disk if you run tcp/ip much.  Read mostly.
  13264.        6. A very strong suggestion would be to put this file on a different
  13265.           disk partition.  Backup message files tend to get forgotten and
  13266.           expand at a very high rate.  If they fill up the primary MSYS
  13267.           disk, MSYS will no longer be able to accept messages.  If the
  13268.           MAIL.BAK directory is on a different drive, the most that can
  13269.           happen when that drive is full is that MSYS just will not make
  13270.           backup copies of the incoming messages.
  13271.  
  13272.  
  13273.        Example 1.  Lets move the mail.bak directory to the D: drive.  It is
  13274.        appropriate to put the SET command in the AUTOEXEC.BAT so that it
  13275.        will happen on a reboot.  You would put the statement:
  13276.        SET MSYS:MAIL.BAK=D:\MAIL.BAK
  13277.        in the AUTOEXEC.BAT file.  MSYS will then look for the mail backup
  13278.        directory on the D: drive.
  13279.  
  13280.        CAUTION  MUTIL Functions always assume the C:\MSYS directory path!
  13281.        When doing MUTIL functions, you MUST specify the changed path!
  13282.  
  13283.  
  13284.  
  13285.  
  13286.  
  13287.        MSYS 1.18                                                   Page 209
  13288.  
  13289.  
  13290.  
  13291.  
  13292.  
  13293.        Example 2.  Assume you still have a ram disk at E: and have copied
  13294.        the  normal contents of BBSTONTS.BIN to that disk.  You could do the
  13295.        following DOS command:
  13296.  
  13297.        SET MSYS:BBSTONTS.BIN=E:BBSTONTS.BIN
  13298.        to cause MSYS to read the file from your RAMDISK.
  13299.  
  13300.        NOTE: With all these changes you can make, you can configure a lot in
  13301.        terms of files now.  Be careful of file sizes when thinking about
  13302.        where to put things.  MSYS.LOG grows endlessly as does the MAIL.BAK
  13303.        directory.  These two are VERY good candidates for another drive so
  13304.        as to NOT accidentally run out of disk space and bring the bbs to a
  13305.        humbled state.
  13306.  
  13307.        NOTE:  The programs in MUTIL assume the files are where they should
  13308.        be and totally ignore any replacements you may have made of file
  13309.        names and/or directory names.
  13310.  
  13311.        NOTE: If you are not absolutely sure of what you are doing, don't (do
  13312.        anything with these facilities).
  13313.  
  13314.        NOTE: Before you try any of this, MAKE BACKUPS OF EVERYTHING!
  13315.  
  13316.  
  13317.  
  13318.  
  13319.  
  13320.  
  13321.  
  13322.  
  13323.  
  13324.  
  13325.  
  13326.  
  13327.  
  13328.  
  13329.  
  13330.  
  13331.  
  13332.  
  13333.  
  13334.  
  13335.  
  13336.  
  13337.  
  13338.  
  13339.  
  13340.  
  13341.  
  13342.  
  13343.  
  13344.  
  13345.  
  13346.  
  13347.  
  13348.        MSYS 1.18                                                   Page 210
  13349.  
  13350.  
  13351.  
  13352.  
  13353.  
  13354.  
  13355.                 MSYS MSG FILE FORMAT:(For the adventuresome only!)
  13356.  
  13357.        (If you know what you are doing, this will make some sense to you)
  13358.  
  13359.        int head;   /* slot number of head of active list */
  13360.        int free;   /* slot number of head of free list */
  13361.        int next;   /* next message number to be assigned */
  13362.  
  13363.        /* Each slot has the following definition: */
  13364.        struct msghdrdef {
  13365.            unsigned  mmsgnr;
  13366.            unsigned char mmsgtype[3];
  13367.            int  mmsgsize;
  13368.            unsigned char mmsgto[7];
  13369.            unsigned char mmsgfrom[7];
  13370.            unsigned char mmsgatbbs[39];
  13371.            unsigned char mmsgdate[7];
  13372.            unsigned char mmsgtitle[40];
  13373.            long mmsgbits;
  13374.            unsigned char mmhbbs[8];
  13375.            unsigned char mmsgtries;
  13376.            unsigned char mmsgbid[15];
  13377.            int  mmsglink;
  13378.            };
  13379.  
  13380.        /* Note: word alignment is forced for all ints & longs */
  13381.  
  13382.  
  13383.  
  13384.  
  13385.  
  13386.  
  13387.  
  13388.  
  13389.  
  13390.  
  13391.  
  13392.  
  13393.  
  13394.  
  13395.  
  13396.  
  13397.  
  13398.  
  13399.  
  13400.  
  13401.  
  13402.  
  13403.  
  13404.  
  13405.  
  13406.  
  13407.  
  13408.  
  13409.        MSYS 1.18                                                   Page 211
  13410.  
  13411.  
  13412.  
  13413.  
  13414.  
  13415.  
  13416.  
  13417.                               ROUTES.DAT FILE FORMAT:
  13418.  
  13419.        This is an ASCII file that contains callsign prefixes and routings.
  13420.        The callsign prefix begins in the first byte.  Comparisons are made
  13421.        with the BBS call for the length of the prefix from this file.  The
  13422.        routing field begins in byte 9 (a tab character can be used to get
  13423.        here).  Here are some sample entries:
  13424.  
  13425.        4X    ISR.AS
  13426.        9M2   MYS.AS
  13427.        A     USA.NA
  13428.  
  13429.        The idea here is that incoming messages for a given bbs will get the
  13430.        routing appended to the @BBS field.  Thus if someone sent a message
  13431.        to 4X1ABC  @  4X1XYZ  the @ field would become @4X1XYZ.ISR.AS
  13432.  
  13433.        It is expected in your forward file you would either have provisions
  13434.        to route the country part (ISR) to some bbs,  or the continent part
  13435.        (AS) to some bbs.  Thus to route foreign messages, you might just
  13436.        have all the continent designators (like EU,  AS, NA  etc.) in your
  13437.        forwarding file or you can be more selective. Remember that you can
  13438.        have some countries along with the continent routings in your forward
  13439.        file.  The part of the @BBS from left to right that is found in the
  13440.        forwarding file is the one that is used.  If you do a lot of direct
  13441.        forwarding to various countries that can be accommodated; if you just
  13442.        dump all  foreign stuff  on a single station that is easy too.  Feel
  13443.        free to modify the contents of ROUTES.DAT as you see fit;  I have
  13444.        just included country prefixes for countries for which I seen message
  13445.        headers pass through my system.
  13446.  
  13447.  
  13448.  
  13449.  
  13450.  
  13451.  
  13452.  
  13453.  
  13454.  
  13455.  
  13456.  
  13457.  
  13458.  
  13459.  
  13460.  
  13461.  
  13462.  
  13463.  
  13464.  
  13465.  
  13466.  
  13467.  
  13468.  
  13469.  
  13470.        MSYS 1.18                                                   Page 212
  13471.  
  13472.  
  13473.  
  13474.  
  13475.  
  13476.  
  13477.        The following program may be used to create a BBSLIST.DAT file
  13478.        from the BBSTONTS.DAT file supplied on distribution disk:
  13479.  
  13480.        10 OPEN "BBSTONTS.DAT" FOR INPUT AS 1
  13481.        20 OPEN "BBSLIST.NEW" FOR OUTPUT AS 2
  13482.        30 IF EOF(1) THEN CLOSE:END
  13483.        40 LINE INPUT #1,A$
  13484.        50 I=1:C$="":  WHILE  MID$(A$,I,1)<>" "  :C$=C$+MID$(A$,I,1):
  13485.             I=I+1: WEND
  13486.        60 D$=MID$(A$,35,6)
  13487.        70 H$=MID$(A$,10,25)
  13488.        90 IF LEFT$(D$,2)="99" THEN 30
  13489.        100 X$=LEFT$(C$,1): IF X$>="0" AND X$<="9" THEN 120
  13490.        110 X$=MID$(C$,2,1): IF X$>="0" AND X$<="9" THEN C$=" "+C$
  13491.        120 PRINT #2,C$;TAB(8);H$;TAB(74);D$
  13492.        130 GOTO 30
  13493.  
  13494.        You may use a text editor to extract the program from this file. The
  13495.        result of this program is put in a file called BBSLIST.NEW.  It may
  13496.        be renamed to BBSLIST if you don't have one already.  Or you can
  13497.        merge your file with this one by using the following commands:
  13498.        copy BBSLIST.DAT+BBSLIST.NEW TEMP
  13499.        del BBSLIST.DAT
  13500.        ren TEMP BBSLIST.DAT
  13501.        Then run MUTIL function 20 to sort the file and discard the
  13502.        duplicates from the BBSLIST.NEW file.
  13503.  
  13504.  
  13505.  
  13506.  
  13507.                               MSYS under WINDOWS 3.1
  13508.  
  13509.        To run MSYS in the background mode with Windows 3.1 you must make a
  13510.        PIF file called MSYS.PIF.  The secret is when you get ready to save
  13511.        the MSYS.PIF file, show the path as:
  13512.  
  13513.             c:\windows\msys.pif
  13514.        NOT
  13515.             c:\msys\msys.pif.
  13516.  
  13517.        Try using the variable 130 for background and 110 for foreground to
  13518.        give the best results for timesharing.
  13519.  
  13520.  
  13521.  
  13522.  
  13523.  
  13524.  
  13525.  
  13526.  
  13527.  
  13528.  
  13529.  
  13530.  
  13531.        MSYS 1.18                                                   Page 213
  13532.  
  13533.  
  13534.  
  13535.  
  13536.  
  13537.  
  13538.                                 MSYS under DesqView
  13539.  
  13540.        To run MSYS under DesqView 386 Version 2.4 on a 386 or a 486 machine,
  13541.        try these values in the "Add Program" (AP) setup:
  13542.             O (for Other) F1 (to specify Program Information)
  13543.             PROGRAM NAME = MSYS
  13544.             Keys To Use = MS (or your choice!)
  13545.             Memory Size = (as big as you can make it - try 620K)
  13546.             Program  = C:\MSYS\MSYS.EXE (be sure to specify proper drive and
  13547.                                           sub-directory)
  13548.             Directory = C:\MSYS
  13549.             Writes text directly to screen     [Y]
  13550.             Displays graphics information [N]
  13551.             Virtualize text/graphics (Y,N,T)   [Y]
  13552.             Uses serial ports (Y,N,1,2)        [Y]
  13553.             Requires floppy diskette           [N]
  13554.             F1 for advanced options
  13555.             Starting Height:                   25
  13556.             Starting Row.                       0
  13557.             Starting Width.                    80
  13558.             Starting Column:                    0
  13559.             Close on exit (Y,N,blank)          [ ]
  13560.             Uses its own colors                [Y]
  13561.             Allow Close Window  command        [Y]
  13562.             Runs in background (Y,N,blank)     [ ]
  13563.             Uses math  coprocessor             [Y]
  13564.             Keyboard conflict (0-F):           [0]
  13565.             Share   CPU   when   foreground    [Y]
  13566.             Share EGA when foreground/zoomed   [Y]
  13567.             Can be swapped out (Y,N,blank)     [ ]
  13568.             Protection level (0-3)             [0]
  13569.  
  13570.        To run MSYS under DesqView on a 386 machine, try these values in the
  13571.        "performance" section:
  13572.             foreground 3
  13573.             background 2
  13574.             common memory 15
  13575.             dos buffer for ems 5
  13576.             optimize communications Y
  13577.             allow swapping of programs N
  13578.             manage printer contention N
  13579.  
  13580.  
  13581.  
  13582.  
  13583.  
  13584.  
  13585.  
  13586.  
  13587.  
  13588.  
  13589.  
  13590.  
  13591.  
  13592.        MSYS 1.18                                                   Page 214
  13593.  
  13594.  
  13595.  
  13596.  
  13597.  
  13598.  
  13599.        If you choose to use QEMM as your memory manager, the following line
  13600.        in your CONFIG.SYS file should give satisfactory results:
  13601.  
  13602.             DEVICE=C:\QEMM\QEMM386.SYS RAM ROM
  13603.  
  13604.             NOTE:  A WORD OF CAUTION:
  13605.        When using QEMM-386, the /ST:M option in the DEVICE=  line will cause
  13606.        MSYS to not load properly.  There may be other options which will
  13607.        also cause grief.  These suggestions are not necessarily the optimum
  13608.        settings for your system,  but they have been known to work.
  13609.  
  13610.        If you are running QEMM version 7, and are NOT running under
  13611.        DesqView, running the command:  LOADHI /LINK before loading MSYS will
  13612.        make additional memory available to MSYS.
  13613.  
  13614.        If you are running QEMM and are running under DesqView, if you have
  13615.        no other need for graphics, you may use the: VIDRAM ON command to
  13616.        make additional memory available to MSYS.
  13617.  
  13618.  
  13619.  
  13620.  
  13621.  
  13622.  
  13623.  
  13624.  
  13625.  
  13626.  
  13627.  
  13628.  
  13629.  
  13630.  
  13631.  
  13632.  
  13633.  
  13634.  
  13635.  
  13636.  
  13637.  
  13638.  
  13639.  
  13640.  
  13641.  
  13642.  
  13643.  
  13644.  
  13645.  
  13646.  
  13647.  
  13648.  
  13649.  
  13650.  
  13651.  
  13652.  
  13653.        MSYS 1.18                                                   Page 215
  13654.  
  13655.  
  13656.  
  13657.  
  13658.  
  13659.  
  13660.                          SYSOP COMMANDS RELATED TO TCP/IP
  13661.  
  13662.  
  13663.        MYIpaddr
  13664.             Takes four integers in the range 0 to 255.  It sets the IP
  13665.             address that the system will respond to.  Example: MYI 44 70 4 6
  13666.             If MYIpaddress is not specified, or set to all zeros, the TCP/IP
  13667.             support will be inactive.
  13668.  
  13669.        MYTcpcall
  13670.             Takes a callsign (with SSID) that will be used when sending arp
  13671.             and TCP/IP frames.  It can be the same as the ID  call in most
  13672.             cases.
  13673.  
  13674.        TElnet
  13675.             Takes an IP address and optional server number as parameters.  A
  13676.             symbolic IP address may given to be looked up in the file
  13677.             MSYSHOST.NET.  Default server is 23.  This command is used to
  13678.             establish keyboard to keyboard connection with a TCP/IP station.
  13679.             Examples: TE [44.70.4.10]
  13680.                       te hsp   (hsp would have to be defined in
  13681.             MSYSHOST.NET)
  13682.  
  13683.             TElnet operates much like C# normally used to connect to AX.25
  13684.             stations.  ^Cd is used to disconnect.
  13685.  
  13686.        TPorts
  13687.             Takes a port mask value as an argument.  This number is used the
  13688.             same way as in the other similar commands: each port corresponds
  13689.             to a port (port 0 is the rightmost bit) and when the bit is set
  13690.             to 1 for a given port that port is available for TCP/IP use
  13691.             (particularly ARP broadcasts).
  13692.  
  13693.        ARP
  13694.             Used without an argument lists the known callsign/IP address
  13695.             correspondence determined by TElnet connects.  An optional
  13696.             argument, CLEAR, may be used to erase all of the ARP entries.
  13697.  
  13698.        FTP
  13699.             Takes a host-id as an argument (it can be either an IP address
  13700.             in the square brackets or a symbolic IP address).  It
  13701.             establishes a connection to the FTP server of the specified
  13702.             system.  FTP is the File Transfer Protocol used in TCP/IP.
  13703.  
  13704.  
  13705.  
  13706.  
  13707.  
  13708.  
  13709.  
  13710.  
  13711.  
  13712.  
  13713.  
  13714.        MSYS 1.18                                                   Page 216
  13715.  
  13716.  
  13717.  
  13718.  
  13719.  
  13720.  
  13721.        SMTP
  13722.             Allows local access to the SMTP server (mainly for test
  13723.             purposes).
  13724.  
  13725.  
  13726.        Note: The following servers are currently implemented in MSYS:
  13727.                  7     Echo
  13728.                  9     Discard
  13729.                  21    BBS
  13730.                  23    Telnet
  13731.                  25    Simple Mail Transfer Protocol
  13732.                  87    Local keyboard
  13733.  
  13734.  
  13735.                               Files related to TCP/IP
  13736.  
  13737.        MSYSHOST.NET
  13738.  
  13739.             This is an ASCII file you create with an editor (such as the
  13740.             MSYS EF command).  Each line in the file begins with an IP
  13741.             address that includes the periods but not the square brackets
  13742.             around it.  Following this there is at least one space and/or
  13743.             tab character, then the list of symbolic names (or aliases, or
  13744.             nicknames, what ever you want to call them).  You may place
  13745.             comments on the line by beginning the comments with a pound sign
  13746.             (#).  Example entry line for this file:
  13747.  
  13748.        44.70.4.6 bxn mike wa8bxn # kirtland, oh
  13749.  
  13750.             This line would allow "bxn" "mike" or "wa8bxn" to be used as
  13751.             arguments in the TElnet and FTP commands. Note that WA8BXN here
  13752.             just happens to look like a callsign.  The actual callsign (and
  13753.             SSID) associated with a particular IP address is determined by
  13754.             ARP (address resolution protocol) broadcasts.  These symbolic
  13755.             names you define in this file simply relieve you of having to
  13756.             remember (and type) complete IP addresses.  Nothing more,
  13757.             nothing less!  See sample for MSYSHOST.NET file.
  13758.  
  13759.  
  13760.  
  13761.  
  13762.  
  13763.  
  13764.  
  13765.  
  13766.  
  13767.  
  13768.  
  13769.  
  13770.  
  13771.  
  13772.  
  13773.  
  13774.  
  13775.        MSYS 1.18                                                   Page 217
  13776.  
  13777.  
  13778.  
  13779.  
  13780.  
  13781.  
  13782.        MSYSPASS.DAT
  13783.  
  13784.             This file contains the user names and passwords for FTP users.
  13785.             Each line contains 3 or 4 items: username password access
  13786.             directory Username is the name the user will use to log in.  It
  13787.             can be anything for a given user.  It could be their callsign or
  13788.             something else.  The password can also be anything.  If you put
  13789.             * as the password in the file for a particular, any password
  13790.             given by the user will be accepted.  The third entry on each
  13791.             line, access, is a number that says how much access the user
  13792.             will have to your system: 1 means can only read files, 3 means
  13793.             read and write (but not replace or delete) and 7 means read,
  13794.             write, replace and delete.  You shouldn't set 7 for any user
  13795.             since the passwords given by a user can be monitored by others.
  13796.             The last item which should always be given is the root directory
  13797.             that the user will have. They may never go closer to the real
  13798.             root than what you give here.
  13799.  
  13800.        Here are some examples:
  13801.  
  13802.             anonymous * 1 files      This allows user anonymous to read
  13803.                                      any files in MSYS/FILES and any of
  13804.                                      its subdirectories.  Any password can
  13805.                                      begiven for this user.  Anonymous with
  13806.                                      * for the password is an expected
  13807.                                      "standard" entry for  TCP/IP systems to
  13808.                                      give access to totally public files.
  13809.                                      Include it in your system.
  13810.             apple runtime 3          This allows user apple (who must give
  13811.                                      password runtime) read/write access
  13812.                                      to your entire disk (DEFAULT DIRECTORY
  13813.                                      IS THE REAL ROOT DIRECTORY!)
  13814.  
  13815.  
  13816.  
  13817.  
  13818.  
  13819.  
  13820.  
  13821.  
  13822.  
  13823.  
  13824.  
  13825.  
  13826.  
  13827.  
  13828.  
  13829.  
  13830.  
  13831.  
  13832.  
  13833.  
  13834.  
  13835.  
  13836.        MSYS 1.18                                                   Page 218
  13837.  
  13838.  
  13839.  
  13840.  
  13841.  
  13842.  
  13843.                               USER ACCESS level chart
  13844.  
  13845.             Level 1: CD DIR GET PWD QUIT
  13846.             Level 3: PUT MKDIR
  13847.             Level 7: PUT (to replace existing file) DELE RMDIR
  13848.  
  13849.        If you are going to allow level 7 access (i.e., can do everything) I
  13850.        would suggest you also assign a directory that doesn't allow access
  13851.        to any needed files.  For example, you might set up the following
  13852.        entry in the MSYSPASS.DAT file:
  13853.  
  13854.        WA8BXN MIKE 7 /MSYS/FILES/WA8BXN
  13855.  
  13856.        You will have to create a directory WA8BXN in the files directory.
  13857.        Now stations can log in with WA8BXN MIKE and do anything in
  13858.        /MSYS/FILES/WA8BXN and any directories found in this directory.
  13859.  
  13860.        If you set up ANONYMOUS * 1  /MSYS/FILES then the user ANONYMOUS can
  13861.        read anything put in the WA8BXN subdirectory of FILES (as well as in
  13862.        FILES itself) but not write or otherwise change anything.  The rest
  13863.        of your files should be pretty well protected.
  13864.  
  13865.  
  13866.                                    FTP COMMANDS:
  13867.  
  13868.        When you use the FTP command to connect to another system you can
  13869.        type: HELP to get a list of the supported commands.  They currently
  13870.        include:
  13871.             CD dirname     To move around in the directory structure
  13872.             CD             with no arguments gives the current directory
  13873.             DELE filename  To delete given file
  13874.             DIR filespec   gives a directory listing
  13875.             GET filename   downloads a the given file
  13876.             MKDIR          makes a directory
  13877.             PUT filename   uploads the given file  Syntax is:
  13878.                  put [localfilename] remotefilename
  13879.                  If the optional localfile name is omitted it is assumed to 
  13880.                       be the same as the remote file name.
  13881.             PWD            gives the current directory
  13882.             QUIT           disconnects
  13883.             RMDIR dirname  removes the given directory
  13884.  
  13885.             FTP function   will give an estimate on the number of bytes
  13886.                            transferred during GET and PUT commands.
  13887.  
  13888.  
  13889.  
  13890.  
  13891.  
  13892.  
  13893.  
  13894.  
  13895.  
  13896.  
  13897.        MSYS 1.18                                                   Page 219
  13898.  
  13899.  
  13900.  
  13901.  
  13902.  
  13903.  
  13904.                                     IP Routing:
  13905.  
  13906.        What does this mean?  Its sort of like digipeaters for the TCP/IP
  13907.        world.  If a TCP/IP user sets you up as a route for IP frames going
  13908.        to a particular IP address MSYS will now repeat them if it has (or
  13909.        can get through an ARP request broadcast) a  known route to the
  13910.        DEStination IP address.  Consider the following fictitious example:
  13911.        W9AAA [44.60.1.1] is in Indiana and wishes to connect to W3AAA
  13912.        [44.80.1.1] in Pennsylvania but can't do it directly.  W9AAA can
  13913.        reach W8AAA [44.70.1.1] in Ohio who can in turn reach W3AAA.  W9AAA
  13914.        will set up the route to [44.80.1.1] to be W8AAA (an  MSYS system).
  13915.        When attempting to connect to W3AAA (using Telnet,  for example) will
  13916.        send out a SYN IP  frame (connect request) to callsign W8AAA but with
  13917.        an IP address of [44.80.1.1], the IP address of W3AAA.  W8AAA upon
  13918.        hearing this will check its ARP table to see if it knows how to get
  13919.        to [44.80.1.1].  If the entry is not there, W8AAA will do an ARP
  13920.        broadcast on all the ports enabled for TCP/IP.  W3AAA will respond on
  13921.        one of them and this will put an entry in the ARP table.  Now when a
  13922.        SYN is heard from W9AAA it will be repeated by W8AAA and thus heard
  13923.        by W3AAA.
  13924.  
  13925.        To use IP ROUTING yourself in MSYS you use the arp add command.  When
  13926.        adding a given IP address you would put the call of the TCP/IP
  13927.        station you want to use as an IP repeater in place of the call that
  13928.        belongs with the IP address.  You can still use normal AX.25
  13929.        digipeaters (up to 8) to reach the TCP/IP station.  If the path from
  13930.        W8AAA to W3AAA in the above example was not direct,  then the
  13931.        following arp entry could be done at W8AAA, assuming that K8AAA is a
  13932.        normal AX.25 digipeater: arp add W3AAA port# 44 80 1 1 K8AAA
  13933.  
  13934.        NOTE:  For more on TCP/IP refer to The KA9Q Internet Software
  13935.        Package.
  13936.  
  13937.        In the TCP/IP related ARP command, use: -2 as the port number for
  13938.        routing through the network interface.
  13939.  
  13940.        TCP/IP connects are rejected if not enough memory or MCON is
  13941.        exceeded.
  13942.  
  13943.  
  13944.  
  13945.  
  13946.  
  13947.  
  13948.  
  13949.  
  13950.  
  13951.  
  13952.  
  13953.  
  13954.  
  13955.  
  13956.  
  13957.  
  13958.        MSYS 1.18                                                   Page 220
  13959.  
  13960.  
  13961.  
  13962.  
  13963.  
  13964.  
  13965.                                EDITVIEW (ED Command)
  13966.                      (c) Copyright 1994 by HUB COMPUTERS, INC.
  13967.  
  13968.        Commands    The ED command used from the MSYS command mode can be
  13969.        used to edit small text files.  The file is limited to records each
  13970.        80 bytes or less in length.  By default up to 200 records may be in
  13971.        the file.  This can be modified by giving the maximum number of lines
  13972.        after the file name.  The intent of this editor is to do little
  13973.        things without having to take down the system to run a more powerful
  13974.        editor.  These might include editing message texts, the forward file,
  13975.        etc.
  13976.  
  13977.        ED is a full window editor (it adjusts its operation to fill the
  13978.        window it is run in).  It must be run in a window that is 80
  13979.        characters wide.  Thus using the default window definitions it can be
  13980.        run in the normal command window (0) or you can use the CMdwindow
  13981.        command to first go to window 4 (the one you get when you press F4)
  13982.        and then use the ED command.  You will then be using the entire
  13983.        screen for your editing.
  13984.  
  13985.        ED is pretty much a what you see is what you get editor.  There are
  13986.        two modes of operation.  When you start the editor you are in full
  13987.        screen or edit mode in which changes you make to the screen are also
  13988.        made to the file.  In this mode you get a line at the bottom of the
  13989.        window that gives such information as the current line number and the
  13990.        name of the file being edited.  The other mode is command mode in
  13991.        which you give commands to be done by the editor.  To enter command
  13992.        mode press the Escape key.  The bottom line will change to Edit Cmd:
  13993.        and await your command.  The command you type will appear on this
  13994.        bottom line.  To get a list of available commands type Help.  You
  13995.        should see something that looks like the following:
  13996.  
  13997.  
  13998.           Find   locates given string .  Example:  F wa8bxn
  13999.                  Notes: Not case sensitive .
  14000.           F10    from edit mode is find same string again.
  14001.           Insert puts blank line at beginning of file
  14002.           QUIT   Abandons edit
  14003.           SAVE   Saves file and exits
  14004.           DELete Delete specified # of lines from  file  beginning with
  14005.                  current line
  14006.           Return key in edit mode with insert on inserts blank lines
  14007.  
  14008.        Press a key to return to edit
  14009.  
  14010.        Use of the keypad to move around in the file is what is expected of
  14011.        the labeled keys, with the following enhancements.  If you are
  14012.        somewhere in a line and you press the Home key,  you go to the
  14013.        beginning of the current line.  If you are the beginning of the
  14014.        current line and press Home,  you go to the beginning of the screen.
  14015.        If you are at the beginning of the screen, pressing Home takes you to
  14016.        the beginning of the file.
  14017.  
  14018.  
  14019.        MSYS 1.18                                                   Page 221
  14020.  
  14021.  
  14022.  
  14023.  
  14024.  
  14025.                                EDITFILE (EF Command)
  14026.                      (c) Copyright 1994 by HUB COMPUTERS, INC.
  14027.  
  14028.        The EF command used from the MSYS command mode can be used to edit
  14029.        small text files.  The file is limited to records each 80 bytes or
  14030.        less in length.  By default up to 200 records may be in the file.
  14031.        This can be modified by giving the maximum number of lines after the
  14032.        file name.  The intent of this editor is to do little things without
  14033.        having to take down the system to run a more powerful editor .  These
  14034.        might include editing message texts, the forward file, etc.  This
  14035.        isn't a full screen editor but rather a line editor that was
  14036.        influenced in its design by the UNIX editor.  Plain and simple
  14037.        nothing fancy is found in it.  To begin editing, use the command EF
  14038.        filename when you have the cmd: prompt.  The filename can contain
  14039.        drive and path information.  If the file does not exist you will be
  14040.        given the option to create one by that name.  To create a new file
  14041.        this way, use the Append command.  Type the lines of the new file and
  14042.        then a line with a period at the beginning to exit append mode.  Then
  14043.        use the  commands Write and Quit (each followed by the return key)
  14044.        and you have created a new file.  All of the commands can be
  14045.        shortened to the first letter of the command, except for the DElete
  14046.        command which requires at least the first two letters.
  14047.  
  14048.        Here is information about the edit commands:
  14049.        #  (i.e.,  a line number) makes that line the current line and also
  14050.        displays it
  14051.  
  14052.        + # Makes the current line # more than it is now .  If # is omitted,
  14053.        then the current line is incremented by one.
  14054.  
  14055.        - # Same as + # except current line number is decremented.
  14056.  
  14057.  
  14058.        <ESCAPE> Using the Escape key followed by the Return key abandons
  14059.        edit with no changes made to the file (unless you used the Write
  14060.        command yourself).
  14061.  
  14062.        <RETURN> Pressing the Return key alone displays the next line and
  14063.        makes it the current line.
  14064.  
  14065.        Append enters input mode, placing the following lines of input  AFTER
  14066.        the current line.  A line beginning with a period terminates append
  14067.        mode.
  14068.  
  14069.        Bottom makes the last line the current line and displays it.
  14070.  
  14071.  
  14072.  
  14073.  
  14074.  
  14075.  
  14076.  
  14077.  
  14078.  
  14079.  
  14080.        MSYS 1.18                                                   Page 222
  14081.  
  14082.  
  14083.  
  14084.  
  14085.  
  14086.        Change can be used to replace part of the current line.  The first
  14087.        non-blank character after the command is the quote character.  The
  14088.        operands are quote-character string-to-replace quote-character
  14089.        replacement-string quote-character .  For example,
  14090.             C /YXZ/abc/
  14091.             would replace XYZ in the current line with abc.  The line is
  14092.        printed after it is displayed.
  14093.  
  14094.        DElete can be used to delete the current line.  If a number is
  14095.        specified as an operand, it is the number of lines to delete
  14096.        beginning with the current line.
  14097.  
  14098.        Down moves the current line down the number of lines specified (or 1
  14099.        if none is specified).
  14100.  
  14101.        Find uses the first non-blank character after the command word as the
  14102.        beginning of the search string.  The search is from the current line
  14103.        on in the file.  Case is NOT important.  If a match is found the line
  14104.        is displayed and that line becomes the current line.  If no match is
  14105.        found the current line remains unchanged.
  14106.  
  14107.        Help displays the list of commands.
  14108.  
  14109.        Insert is like Append except that the new lines are placed BEFORE
  14110.        the current line.
  14111.  
  14112.        Near displays the contents of the file 5 lines before and 4 lines
  14113.        after the current line which remains unchanged.
  14114.        Print with no operands displays the current line.  Give 1 operand it
  14115.        displays the line with that number.  Given 2 operands (separated with
  14116.        a blank or comma) it displays from the first to the second line
  14117.        number.  The current line number remains unchanged.
  14118.  
  14119.        Quit is used to exit the editor after the file has been written.
  14120.  
  14121.        Top makes the first line (numbered 0) the current line and displays
  14122.        it.
  14123.  
  14124.        Up decrements the current line number by the number given or 1.
  14125.  
  14126.  
  14127.  
  14128.  
  14129.  
  14130.  
  14131.  
  14132.  
  14133.  
  14134.  
  14135.  
  14136.  
  14137.  
  14138.  
  14139.  
  14140.  
  14141.        MSYS 1.18                                                   Page 223
  14142.  
  14143.  
  14144.  
  14145.  
  14146.  
  14147.  
  14148.        View displays the current line and the 9 lines that follow it.  The
  14149.        current line remains unchanged.
  14150.  
  14151.        Write causes the file to be written to disk with any changes that
  14152.        have been made.
  14153.  
  14154.        ^F is used to search again for the same search string give with last
  14155.        use of Find.
  14156.  
  14157.        To start the editor, type EFile filepathname [# of lines max].
  14158.        Examples:
  14159.        ef msys.fwd 250
  14160.        ef mail/msg25.dat
  14161.        efile a:f1.c
  14162.  
  14163.  
  14164.  
  14165.  
  14166.  
  14167.  
  14168.  
  14169.  
  14170.  
  14171.  
  14172.  
  14173.  
  14174.  
  14175.  
  14176.  
  14177.  
  14178.  
  14179.  
  14180.  
  14181.  
  14182.  
  14183.  
  14184.  
  14185.  
  14186.  
  14187.  
  14188.  
  14189.  
  14190.  
  14191.  
  14192.  
  14193.  
  14194.  
  14195.  
  14196.  
  14197.  
  14198.  
  14199.  
  14200.  
  14201.  
  14202.        MSYS 1.18                                                   Page 224
  14203.  
  14204.  
  14205.  
  14206.  
  14207.  
  14208.  
  14209.                                       Epilog
  14210.  
  14211.        Notes on sending me messages with questions/suggestions/etc.:  I do
  14212.        try to respond to your personal messages.  Keep in mind I do get
  14213.        quite a few at times.  If you want an answer from the author, you
  14214.        need to send the question to the author personally!  Messages that
  14215.        contain demands (add this feature or correct this bug immediately and
  14216.        put out a new release or I won't use your program) generally are
  14217.        saved in the bit bucket.  For a free program, please be considerate!
  14218.        Try to put just one thought/question in each message.  If you bundle
  14219.        up a whole bunch, I don't respond until I can address all your
  14220.        issues.  If you send follow-up messages, please give a sentence or
  14221.        two summary of the problem so that I may understand what you are
  14222.        talking about.  Just saying "I tried what you suggested and it still
  14223.        doesn't work, anything else to try?" doesn't give me much of a clue
  14224.        about the situation.  Although you may have only one problem you are
  14225.        dealing with and can easily remember its entire history,  I don't
  14226.        have that luxury here!  If you find what you think is a bug,  please
  14227.        try to tell me how to reproduce it, what you are seeing, and what you
  14228.        think should be happening.  The harder the problem, the longer it
  14229.        takes me to work on it and respond.  When you run into any sort of
  14230.        problem, simplify  everything as much as possible.  Remove all
  14231.        statements from config.sys, autoexec.bat, msys.opt and msys.do that
  14232.        are not essential to reproduce the bug.  Believe me, this will
  14233.        probably help you find at least half of the problems and their
  14234.        solutions yourself.
  14235.  
  14236.        Use and Enjoy!
  14237.  
  14238.  
  14239.  
  14240.  
  14241.  
  14242.  
  14243.  
  14244.  
  14245.  
  14246.  
  14247.  
  14248.  
  14249.  
  14250.  
  14251.  
  14252.  
  14253.  
  14254.  
  14255.  
  14256.  
  14257.  
  14258.  
  14259.  
  14260.  
  14261.  
  14262.  
  14263.        MSYS 1.18                                                   Page 225
  14264.  
  14265.  
  14266.  
  14267.  
  14268.  
  14269.  
  14270.                                        INDEX
  14271.  
  14272.  
  14273.  
  14274.        !, 102                               Automatic Password Reply, 164
  14275.        !timestring, 102                     AUTONode, 33, 132, 138
  14276.        #, 31, 96, 153                       AX25 CHECK, 15
  14277.        $POOL, 62                            AX25 FRACK, 15
  14278.        *, 82                                AX25 MAXFRAMES, 15
  14279.        *** done, 99, 102                    AX25 RETRIES, 15
  14280.        *comment, 31                         AX25Backoff, 33
  14281.        +, 105                               AX25L2v2, 33
  14282.        .FWD, 97                             BADuser, 33
  14283.        .REV, 97                             BBS, 217
  14284.        /, 82                                BBs, 33
  14285.        /Sysop, 163                          BBS ALIAS, 14
  14286.        <, 82                                BBS CALL, 14
  14287.        <Esc>, 69                            BBS callsign, 58
  14288.        >, 12, 82, 165                       BBS ONLY ACCESS, 153
  14289.        >>, 82                               BBSLIST.DAT, 191, 192, 197
  14290.        ?, 72, 105                           BBSNode, 34
  14291.        @, 105                               BBSTimeout, 34
  14292.        @BBS, 79                             BBSTONTS, 128
  14293.        @home, 31                            BBSTONTS.BIN, 125, 128, 196, 209
  14294.        ^A, 79                               BBSTONTS.DAT, 48, 192, 194, 195,
  14295.        ^Z, 79                                196
  14296.        A, 71                                BDigi, 34
  14297.        ABortfwd, 31                         BElloff, 34
  14298.        ACOUSTIC COUPLED MODEMS, 120         BID, 34, 79, 169
  14299.        ADDITIONS & CHANGES, 4               BID LIST NEARLY FULL, 174
  14300.        ADDUser, 31                          BIDLIST.DAT, 34
  14301.        Alt-F1, 70                           BINterval, 35
  14302.        Alt-F2, 70                           BInterval, 138
  14303.        Alt-F3, 70                           blank lines, 102
  14304.        AMTOR, 140                           BMaxcon, 35
  14305.        ANONYMOUS CHECK-INS, 118             BOOT, 35
  14306.        ANSWER CALL, 14                      BPorts, 35
  14307.        APpend, 31                           BText, 35, 56
  14308.        ARChive, 31                          BUDCall, 33
  14309.        archived messages, 196               BUDCalls, 35, 54
  14310.        ARP, 31, 55, 216                     BUDList, 36
  14311.        arp, 110                             BUFFERS, 172
  14312.        ARP ADD, 32                          Bulletin Forwarding Logic, 126
  14313.        ARP CLEAR, 31                        BUSY, 35
  14314.        ARP DEL, 32                          Bye, 71
  14315.        ARP REP, 32                          C, 71, 138
  14316.        ATtended, 32, 108                    C script, 37
  14317.        AUTODESt, 32, 132, 138               C#, 38
  14318.        AUTOEXEC.BAT, 85, 209                CALLSIGN SERVER, 85
  14319.        AUTOHold, 32                         Callsign Server, 58
  14320.        AUTOKill, 33, 168                    CALLSRV1, 85
  14321.        Automatic Message Holding, 158       CALLSRV2, 85
  14322.  
  14323.  
  14324.        MSYS 1.18                                                   Page 226
  14325.  
  14326.  
  14327.  
  14328.  
  14329.  
  14330.        CALLSRV3, 85                         DOS, 154
  14331.        callword, 116                        DOS 3.3, 177
  14332.        Cancel, 69                           DOS SET, 72
  14333.        CC, 71                               Download, 72
  14334.        CD ROM, 85                           DPorts, 42
  14335.        CGA, 63                              DRoute, 42
  14336.        Change maximum number of             DRoute DELete, 42
  14337.         messages, 180                       DRSI CARDS, 22
  14338.        CHANNEL NUMBERS, 153                 DTimedate, 42
  14339.        CHAnsta, 36                          DUmpbbs, 43
  14340.        CHEck, 36                            DUPcheck, 43
  14341.        Checksum error, 113                  Echo, 217
  14342.        CHKMAIL, 183                         EDit, 43
  14343.        CL B#, 36                            EDITFILE (EF Command), 222
  14344.        CLrscrn, 36                          EDITVIEW (ED Command), 221
  14345.        CMdwindow, 36                        EFile, 43
  14346.        COLOR, 67                            EMsghdr, 43
  14347.        CONFIG.SYS, 85, 172                  END OF LINE BELLS, 154
  14348.        COPy, 36                             EU, 118
  14349.        CRetries, 36                         EUser, 44
  14350.        Ctrl/F2, 70                          EVENT.LOG, 154
  14351.        Ctrl/F4, 60, 70                      EXPANDED MEMORY, 157
  14352.        Ctrl/F5, 70                          EXTENDED, 157
  14353.        Ctrl/F6, 70                          F:HAMBASE, 85
  14354.        CTS, 37, 89                          F1, 70
  14355.        DATABASE HELP, 122                   F2 Time, 44
  14356.        Database.0, 72, 122                  F6, 70
  14357.        datagram, 131                        F8, 70
  14358.        DBADD, 122                           FA, 112
  14359.        DEADletter, 40                       FB, 111
  14360.        DEBug, 40                            FBB, 117
  14361.        DELEfile, 40                         FBB COMPATIBLE COMPRESSED
  14362.        Delete Old BIDS, 198                  FORWARDING, 112
  14363.        DELETE OLD LOG FILES., 174           FBB COMPATIBLE FORWARDING, 111
  14364.        DELUDays, 40                         FBB ON THE PHONE, 117
  14365.        DELUSer, 40                          FBBC, 45, 94
  14366.        DesqView, 214                        FBBStimes, 45
  14367.        DESt, 68                             FCall, 45
  14368.        DESt ADD, 40, 133, 138               FF, 111
  14369.        DESt DEL, 41, 133, 138               FFile, 45
  14370.        DESt REP, 40, 133, 138               FIle, 45
  14371.        DEStination, 110, 133                FILES, 172, 208
  14372.        DEStination NODe, 131                Files related to TCP/IP, 217
  14373.        Device Errors, 153                   files=40, 2
  14374.        DFree, 41                            Fix mail index file, 192
  14375.        DIGipeats, 41                        FMsg, 46
  14376.        DIR, 129                             FOrward, 46
  14377.        DIRectory, 41                        FORWARD CALL, 14, 137
  14378.        Discard, 217                         Forward File Description, 94
  14379.        DISconnect, 42                       FORWARDING, 93
  14380.        Disk Full Message, 153               FORWARDING DISPLAY, 103
  14381.        DOcmdfile, 42                        FORWARDING NOTES, 102
  14382.        Domain.txt, 187
  14383.  
  14384.  
  14385.        MSYS 1.18                                                   Page 227
  14386.  
  14387.  
  14388.  
  14389.  
  14390.  
  14391.        FORWARDING ON THE MODEM PORT,        INitpr, 49
  14392.         116                                 INPUT BUFFER SPACE LOW, 174
  14393.        FORWARDING TO JNOS SYSTEMS, 107      IP, 65
  14394.        FQ, 112                              IP Routing, 220
  14395.        FRACK, 66                            IPNCheck, 49
  14396.        FRAck, 46                            IPNFrack, 49
  14397.        FREE, 46                             IPNRetry, 49
  14398.        FREQUENT PROBLEMS, 172               IPTtl, 49
  14399.        FS, 111                              IRQs, 156
  14400.        FTIme, 46                            J, 137
  14401.        FTP, 206, 216                        j-com, 85
  14402.        FTP COMMANDS, 219                    JBbs, 49, 73
  14403.        FTPgm, 47                            JDigipeat, 49, 73
  14404.        FUllduplex, 47                       JGateways, 49, 73
  14405.        Function key usage, 30, 70           JH, 73
  14406.        FWD, 208                             JHeard, 49
  14407.        fwd directory, 102                   JKanodes, 50, 73
  14408.        G, 123                               JKISS EPROM, 161
  14409.        GEtmsgotd, 47                        JMsys, 50, 73
  14410.        GMT, 65                              JNetrom, 50, 73
  14411.        GMtime, 47                           JTcp/ip, 50
  14412.        GR, 72                               Justheard, 137
  14413.        GREP, 208                            K, 73
  14414.        GRep, 47                             K*, 73
  14415.        grepdir, 72                          K<, 74
  14416.        GTOR, 12, 140                        K>, 74
  14417.        GTOR FORWARDING, 108, 143            K@, 74
  14418.        GTOR LIMITATIONS, 144                KAM Plus, 140
  14419.        GTOR MANUAL CONNECTS, 142            KANODE CALL, 14
  14420.        GTOR TROUBLESHOOTING, 144            KANTRONICS 3.0 EPROM, 171
  14421.        GX, 72                               KEYBOARD, 154
  14422.        H, 72                                KEyboard, 50
  14423.        HApnstat, 47                         KF, 73
  14424.        HARDWARE, 140                        KILL, 160
  14425.        HCAll, 47, 168                       Kill, 73
  14426.        HCL, 129                             KILLproc, 50
  14427.        HCLean, 48, 189                      KM, 73
  14428.        HEADERS, 154                         KPorts(MASK), 51
  14429.        HEard, 48                            KT, 73
  14430.        HELP, 8, 208                         L, 74
  14431.        HF Forwarding, 108                   L#, 74
  14432.        Hierarchical, 110                    L$, 74
  14433.        HIERARCHICAL FORWARDING, 124         L$ # #, 74
  14434.        Hierarchical parsing, 125            L$$, 74
  14435.        HOLdlevel, 48, 160                   L<, 74
  14436.        HOStname, 48                         L>, 74
  14437.        HReplace, 48                         L?, 74
  14438.        I, 72                                L@, 74
  14439.        ID, 48, 72                           LB, 74
  14440.        ID CALL, 15                          LC, 74
  14441.        ID EVERY, 15                         LCount, 51, 103
  14442.        IGNORE, 49                           LF, 74
  14443.        IMport, 49                           LH, 74
  14444.  
  14445.  
  14446.        MSYS 1.18                                                   Page 228
  14447.  
  14448.  
  14449.  
  14450.  
  14451.  
  14452.        LINKED, 155                           Zoom, 90
  14453.        LL, 74                               MODEM SUPPORT, 87
  14454.        LL$ #, 74                            MONBframe, 53
  14455.        LM, 74                               MONCC, 53
  14456.        LN, 74                               MONCF, 53
  14457.        LO, 74                               MONIFrame, 54
  14458.        LOADHI /LINK, 215                    MONITor, 54
  14459.        Local keyboard, 217                  MONITOR BFRAMES, 15
  14460.        LOCKkbd, 51                          MONITOR IFRAMES, 15
  14461.        LOCKUPS, 155                         MONITOR OUTGOING, 16
  14462.        log file analyzer, 188               MONITOR PORTS, 16
  14463.        LOGclose, 51                         MONITOR SFRAMES, 15
  14464.        LT, 74                               MONOCHROME, 67
  14465.        LU, 74                               MONOutgoing, 54
  14466.        LUsers, 51                           MONPorts, 54
  14467.        LY, 74                               MONSframe, 54
  14468.        M, 75                                MONUframe, 54
  14469.        MAIL, 8, 208                         MONxx, 54
  14470.        MAIL BEACON, 155                     More?, 165
  14471.        MAIL.BAK, 8, 61, 156, 209            MSgtrailer, 54
  14472.        MAIL.BIN, 9, 209                     MSYS COMMAND LINE, 6
  14473.        MAKEPrivate, 51, 167                 MSYS Command Summary, 23
  14474.        MASK, 66                             MSYS DIRECTORY LAYOUT, 8
  14475.        MASK INFORMATION, 20                 MSYS GENERAL INFORMATION, 153
  14476.        MASterserver, 171                    MSYS GTOR SCANNING, 144
  14477.        MAStersrv, 51                        MSYS MSG FILE FORMAT, 211
  14478.        MAX, 156                             MSYS Network NODe, 131
  14479.        max hops, 57                         MSYS NODe Forwarding, 107
  14480.        MAXBullag, 51                        MSYS PACTOR SCANNING, 144
  14481.        MAXCHANS, 156                        MSYS SYSOP Commands, 31
  14482.        MAXFrames, 52                        MSYS.BBS, 8, 101, 102
  14483.        maximum number of messages, 180      MSYS.DEF, 11
  14484.        MAXRead, 52                          MSYS.DO, 85, 86, 108, 135, 160,
  14485.        MCForward, 52                         200
  14486.        MCON, 80                             MSYS.EXE, 8
  14487.        MCOn, 52                             MSYS.FWD, 53, 101, 173, 209
  14488.        MDir, 52                             MSYS.HCL, 129
  14489.        MEMory, 52                           MSYS.HRD, 172, 209
  14490.        MEMORY LOW BUSY, 156                 MSYS.LOG, 209
  14491.        MEMORY MANAGEMENT, 156               MSYS.MSG, 180, 209
  14492.        MERge, 2, 53, 98, 101, 197           MSYS.OPT, 10, 172
  14493.        MEXpert, 53                          MSYS.OPT FILES, 89
  14494.        MFJ KISS MODE, 175                   MSYS.OTD, 203
  14495.        MHclear, 53                          MSYS.REP, 121, 203
  14496.        MIDchar, 53                          MSYS.RMT, 67, 163, 164, 182, 204
  14497.        MINmem, 53                           MSYS.USR, 209
  14498.        MISsing, 53                          MSYS:BBSTONTS.BI, 209
  14499.        MISSING TEXT TO Message, 104         MSYS:FILES, 208
  14500.        MODE MONO, 2                         MSYS:FWD, 208
  14501.        MODEM, 12, 89                        MSYS:GREPDIR, 208
  14502.        Modem                                MSYS:HELP, 208
  14503.         Hayes Ultra 96, 91                  MSYS:MAIL, 208
  14504.         US Robotics Sportster, 91           MSYS:MAIL.BAK, 209
  14505.  
  14506.  
  14507.        MSYS 1.18                                                   Page 229
  14508.  
  14509.  
  14510.  
  14511.  
  14512.  
  14513.        MSYS:MAIL.BIN, 209                   MUTIL Function 8, 188
  14514.        MSYS:MSYS.FWD, 209                   MUTIL Function 9, 190
  14515.        MSYS:MSYS.HRD, 209                   MUTIL.EXE, 1, 179
  14516.        MSYS:MSYS.LOG, 209                   MYAlias, 54
  14517.        MSYS:MSYS.MSG, 209                   MYBbs, 54
  14518.        MSYS:MSYS.USR, 209                   MYCall, 54
  14519.        MSYS:MSYSBBSB.DAT, 209               MYIpaddr, 55, 216
  14520.        MSYS:MSYSHOST.NET, 209               MYKnode, 55
  14521.        MSYS:MSYSPASS.DAT, 209               MYTcp, 55, 132, 137, 216
  14522.        MSYS:YAPPDIR, 208                    N, 75
  14523.        MSYSB.EXE., 157                      NAME, 11
  14524.        MSYSBBS.DAT, 94                      NBdcast, 55, 138
  14525.        MSYSBBSB.DAT, 120, 173, 204, 209     NDwindow, 55, 138
  14526.        MSYSFWD.DEF, 2, 53, 94, 98, 101,     neighbor NODe, 131
  14527.         173, 205                            NET NODe Parameters Summary, 138
  14528.        MSYSHCL.DO, 130                      NETBbs, 55, 138
  14529.        MSYSHOLD.DAT, 118, 158               NETCon, 55, 138
  14530.        MSYSHOST.NET, 58, 187, 206, 209      NETFBBC, 55, 139
  14531.        MSYSHOST.NEW, 187                    NETFBBG, 55, 139
  14532.        MSYSK.OTD, 203                       NETFBBStime, 55, 139
  14533.        MSYSMOD.MSG, 119                     NETMax, 139
  14534.        MSYSMSGS.DAT, 172                    NETNode, 55, 92, 132
  14535.        MSYSPASS.DAT, 164, 206, 209, 218     NETOnly, 56, 139
  14536.        MSYSPASS.IP, 165, 206                NETRead, 56, 139
  14537.        MSYSPASS.MOD, 87, 92, 118, 165       NetRom RS-232 Connections, 165
  14538.        MSYSTNC#, 141, 142                   NetRom Serial protocol, 12, 165
  14539.        MSYSTNC.#, 161                       NETTalk, 56, 138
  14540.        MSYSTNC.1, 12, 207                   Network time to live, 57
  14541.        MSYSTNC.2, 90                        NETXBatchsize, 56, 139
  14542.        MSYSTNC.x FILES, 90                  NETXOption, 139
  14543.        MSYSTODO.DAT, 66, 160, 175           NETYapp, 56
  14544.        MUTIL, 128, 172                      NEWUser, 56
  14545.        MUTIL 4, 172, 174                    NH, 75
  14546.        MUTIL Function 1, 180                NInfo, 56, 138
  14547.        MUTIL Function 10, 191               NNode, 56
  14548.        MUTIL Function 11, 192               NOBEacons, 56
  14549.        MUTIL Function 12, 192               NOBUlls, 57
  14550.        MUTIL Function 13, 194               NODe, 57, 131, 132, 133, 134
  14551.        MUTIL Function 14, 196               NODe ADD, 57, 133, 138
  14552.        MUTIL Function 15, 196               NODe DEL, 57, 138
  14553.        MUTIL Function 16, 197               NODe DELete, 133
  14554.        MUTIL Function 17, 197               NODe REP, 57, 133, 138
  14555.        MUTIL Function 18, 197               NODe REStore, 57, 138
  14556.        MUTIL Function 19, 197               NODe SAve, 57, 138
  14557.        MUTIL Function 2, 181                NODe Scripts, 105
  14558.        MUTIL Function 20, 197               NODe SEnd, 138
  14559.        MUTIL Function 21, 198               NODETimeout, 56
  14560.        MUTIL Function 22, 198               NOEMM, 6, 157
  14561.        MUTIL Function 3, 182                NOEXMEM, 6
  14562.        MUTIL Function 4, 183                NOHEARD, 6
  14563.        MUTIL Function 5, 184                NON-AMATEUR CALLSIGNS, 153
  14564.        MUTIL Function 6, 186                NONODE, 6
  14565.        MUTIL Function 7, 187                NORAMHDRS, 6
  14566.  
  14567.  
  14568.        MSYS 1.18                                                   Page 230
  14569.  
  14570.  
  14571.  
  14572.  
  14573.  
  14574.        NPorts, 57, 137, 138                 R, 76
  14575.        NQ, 75                               R # #, 76
  14576.        NRCall, 57, 132, 137, 138            R*, 77
  14577.        NRId, 57, 138                        R+, 77
  14578.        NRS, 12                              R-, 77
  14579.        NTS traffic, 73                      R<, 76
  14580.        NTtl, 57, 138                        R>, 76
  14581.        NUMCHANS, 14                         R@, 76
  14582.        NZ, 75                               RADIOSPEED, 12
  14583.        obsolescence, 57                     Radiospeed, 89
  14584.        OCInit, 57, 138                      RBid, 60
  14585.        OCMin, 57, 136, 138                  RDir, 60
  14586.        OKfrom, 57                           RE, 76
  14587.        OS2 REPORTED PROBLEMS, 177           Readbackup, 60
  14588.        OVERVIEW, 140                        Register 27, 90
  14589.        P, 75                                REM, 76
  14590.        Packet size, 162                     REMOTE SYSOP, 67, 163
  14591.        PAClen, 58                           REMove, 60, 133
  14592.        PACTOR, 12, 140                      REMove DESt, 138
  14593.        PACTOR FORWARDING, 108, 143          REName, 60
  14594.        PACTOR LIMITATIONS, 144              RENUMBERING MESSAGES, 193
  14595.        PACTOR MANUAL CONNECTS, 142          REPLACEABLE DIRECTORY NAMES, 208
  14596.        PACTOR TNC PARAMETERS, 141           REPLACEABLE FILE NAMES, 209
  14597.        PACTOR TROUBLESHOOTING, 144          REPlaces, 60
  14598.        PACTOR/GTOR SET UP, 141              REPly, 77
  14599.        password, 9, 116, 118, 163           REQDIR, 60, 83
  14600.        PASSWORD DIRECTORY, 164              REQFIL, 60, 83
  14601.        PASSWORD.RMT, 67, 164                REQMaxfil, 61
  14602.        PATh, 58                             REQQTH, 61, 83, 85
  14603.        PC, 58, 85                           REQxxx SERVERS, 83
  14604.        PF, 76                               RES, 77
  14605.        PForward, 58                         RESPonsetime, 61
  14606.        PIng, 58                             RESTore, 61
  14607.        PMessage, 58                         RETries, 61
  14608.        poll, 99                             REVERSE FORWARD, 98
  14609.        Port speed, 89                       Reverse forwarding, 99
  14610.        POrts, 58                            RH, 76
  14611.        PPersist, 59, 162                    RLinetime, 62
  14612.        PQuality, 59, 138                    RM, 76
  14613.        PRInt, 59                            RN <msg#>, 76
  14614.        Print forwarding tree, 186           ROUTES.DAT FILE FORMAT, 212
  14615.        Print remote sysop phrase number     Routing, 131
  14616.         table, 182                          RP, 76
  14617.        printer, 198                         RS, 77
  14618.        Printer status, 197                  RUn, 62
  14619.        PROcesses, 59                        S, 78
  14620.        PRTmsgs, 59                          SAM (c), 85
  14621.        PScan, 59                            SAMPLES OF MSYS FILES, 199
  14622.        PUBLIC, 9                            SB, 79
  14623.        PWindow, 59                          SCreensave, 63
  14624.        QEMM, 177, 215                       SE-, 4, 63
  14625.        Qmsg, 60                             SELECTIVE FORWARDING, 99
  14626.        QUIT, 60, 70                         SEnd, 63
  14627.  
  14628.  
  14629.        MSYS 1.18                                                   Page 231
  14630.  
  14631.  
  14632.  
  14633.  
  14634.  
  14635.        servers, 217                         TREtries, 66, 138
  14636.        SET, 209                             TRUncate, 66
  14637.        Set, 209                             TS, 66
  14638.        SET TZ, 175                          TSR, 85
  14639.        SETUP, 3                             TTimeout, 66, 138
  14640.        setup, 190                           Tucson Amateur Packet Radio, 161
  14641.        SHUTdown, 63                         Tuscon Amateur Packet Radio, 207
  14642.        SHUtdown, 4                          TXD, 162
  14643.        Simple Mail Transfer Protocol,       TXDelay, 66
  14644.         217                                 TXT, 162
  14645.        SLottime, 63, 162                    TXTail, 66
  14646.        SMTP, 63, 77, 110, 165, 217          TYpe, 67
  14647.        SMTP FORWARDING, 110                 Type of Message, 167
  14648.        SNow, 63                             U, 80
  14649.        SOrt, 63                             UPload, 80
  14650.        Special KISS Parameters, 162         USER BIT SETTINGS, 170
  14651.        SR, 77                               USER Commands, 71
  14652.        SSID, 137                            USER PASSWORD, 164
  14653.        ST, 79                               Users, 67
  14654.        STACK, 17, 166                       V, 80
  14655.        STACKS, 154, 157                     V1SIT, 118
  14656.        STatus, 64, 104                      VAlidmsg, 4
  14657.        SUspendtrace, 64                     VAlidmsgtype, 67
  14658.        SYSOP, 77                            VErifysysop, 67
  14659.        SYsop, 64                            VIdeo, 67
  14660.        SYSOP NAME, 18                       VIDRAM, 156, 215
  14661.        SYSOP QTH, 18                        visit, 118
  14662.        SYSOP ZIP, 18                        W, 80
  14663.        SYSTEM APPEARS TO BE STUCK WHILE     W?, 69
  14664.         ANALIZING FORWARD FILE, 174         W0RLI STANDARD FOR DATA
  14665.        SYSTEM REBOOTS AFTER FORWARDING,      COMPRESSION, 114
  14666.         174                                 WAtch, 67
  14667.        T, 80                                WBackgrnd, 67
  14668.        TABs, 64                             WColors, 67
  14669.        TACK, 64, 138                        WForegrnd, 68
  14670.        TBdelay, 65, 138                     WHO, 68, 163
  14671.        TCP/IP, 55, 66, 132, 137, 216        WHY, 68
  14672.        TElnet, 65, 216                      Wildcards, 104
  14673.        Telnet, 206, 217                     wildcards, 75
  14674.        TERM, 65, 166                        WINDOW, 16
  14675.        Test serial ports, 184               Window, 68
  14676.        TESTING, 166                         WINDOW DISPLAY MONOCHROME, 2
  14677.        TFrames, 65                          WINDOWS 3.1, 213
  14678.        TIME, 175                            WP, 118
  14679.        TImezone, 65                         WP SERVER, 171
  14680.        Titles Truncated, 167                WPAge, 68
  14681.        TNatime, 65, 138                     WPEvery, 68
  14682.        TNC-2, 66                            WQupdate, 68, 138
  14683.        TO FIELD FORWARDING, 101             WRecord, 68
  14684.        TOdo, 66                             WSize, 69
  14685.        TPorts, 66, 216                      X, 44, 81
  14686.        Trace25, 66                          XBatchsize, 69
  14687.        TraceIP, 66                          XC, 44, 81
  14688.  
  14689.  
  14690.        MSYS 1.18                                                   Page 232
  14691.  
  14692.  
  14693.  
  14694.  
  14695.  
  14696.        XF, 44, 81
  14697.        XOption, 69
  14698.        XR, 44, 81
  14699.        XS, 81
  14700.        YAPP, 3, 9, 81, 208
  14701.        Yapp, 69
  14702.        YAPP download, 81
  14703.        YAPP upload, 81
  14704.        YD, 81
  14705.        YU, 81
  14706.        YW, 81
  14707.  
  14708.  
  14709.  
  14710.  
  14711.  
  14712.  
  14713.  
  14714.  
  14715.  
  14716.  
  14717.  
  14718.  
  14719.  
  14720.  
  14721.  
  14722.  
  14723.  
  14724.  
  14725.  
  14726.  
  14727.  
  14728.  
  14729.  
  14730.  
  14731.  
  14732.  
  14733.  
  14734.  
  14735.  
  14736.  
  14737.  
  14738.  
  14739.  
  14740.  
  14741.  
  14742.  
  14743.  
  14744.  
  14745.  
  14746.  
  14747.  
  14748.  
  14749.  
  14750.  
  14751.        MSYS 1.18                                                   Page 233